FaceTime Audio

JavaScript
Python

Installing the SDK

Install the SDK

Bun
pnpm
npm
Yarn

bun add contiguity

pnpm add contiguity

npm install contiguity

yarn add contiguity

Initialize the Client

With API key
From env

import { Contiguity } from "contiguity";
const contiguity = new Contiguity("contiguity_sk_...your_key...");

import { Contiguity } from "contiguity";
// Reads CONTIGUITY_API_KEY or CONTIGUITY_TOKEN
const contiguity = new Contiguity();

Only customers who lease numbers that support FaceTime Audio can use this.

Phone numbers must be in E.164 format. to can also be a FaceTime email.

Dial

const call = await contiguity.facetime.dial({
    to: "+15125550100",
    from: "+18005551234",
    caller_id: "Tesla Support",
});

Answer, reject, hang up

get, answer, reject, and hangup take a call ID, a parsed webhook event, or event.data.

const event = contiguity.webhook.parse(raw_body);

if (event.type === "facetime.call.ringing" && event.data.direction === "inbound") {
    await contiguity.facetime.answer(event, { caller_id: "Support" });
}

await contiguity.facetime.reject(event);
await contiguity.facetime.hangup(event);
const call = await contiguity.facetime.get(event);

Availability

const { available } = await contiguity.facetime.availability("+15125550100");

Join as the number

webrtc.join opens the call as the Contiguity FaceTime Audio line — not a third participant.

FaceTime Web

Once Apple creates it, link is a FaceTime Web URL. Opening it joins as a web participant.

See the JavaScript SDK for the full call object, webhook events, and types. See the FaceTime API for HTTP endpoints.

Installing the SDK

Install the SDK

pip install contiguity

Initialize the Client

import contiguity
client = contiguity.login("your_token_here")

You can also initialize it with the optional ‘debug’ flag:

client = contiguity.login("your_token_here", True)

Python SDK documentation coming soon.

Getting Started

SDK Documentation by Product

SDK Documentation by Language

Installing the SDK

Dial

Answer, reject, hang up

Availability

Join as the number

FaceTime Web

Installing the SDK

​Installing the SDK

​Dial

​Answer, reject, hang up

​Availability

Join as the number

FaceTime Web

​Installing the SDK

Installing the SDK

Dial

Answer, reject, hang up

Availability

Installing the SDK