TypeScript / JavaScript SDK

1
const BASE = "https://api.voicebip.com/v1";
2
const headers = {
3
  Authorization: "Bearer pk_live_xxx",
4
  "Content-Type": "application/json",
5
};
6
7
// Create an agent
8
const agent = await fetch(`${BASE}/agents`, {
9
  method: "POST",
10
  headers,
11
  body: JSON.stringify({ display_name: "Support", language: "en" }),
12
}).then((r) => r.json());
13
14
// Initiate a call
15
const call = await fetch(`${BASE}/calls`, {
16
  method: "POST",
17
  headers,
18
  body: JSON.stringify({
19
    agent_id: agent.agent_id,
20
    from_number: "+2342013501000",
21
    to_number: "+2348031234567",
22
  }),
23
}).then((r) => r.json());
24
25
console.log("Call started:", call.call_id);

1
import { Voicebip } from "@voicebip/sdk";
2
3
const client = new Voicebip({ apiKey: "pk_live_xxx" });
4
5
// Create an agent
6
const agent = await client.agents.create({
7
  displayName: "Customer Support",
8
  language: "en",
9
  systemPrompt: "You are a helpful customer support agent.",
10
});
11
12
// Provision a Nigerian number
13
const number = await client.numbers.provision({
14
  numberId: "num_xxx",
15
  agentId: agent.agentId,
16
  channels: ["voice"],
17
});
18
19
// Initiate an outbound call
20
const call = await client.calls.initiate({
21
  agentId: agent.agentId,
22
  fromNumber: number.e164,
23
  toNumber: "+2348031234567",
24
});
25
26
console.log(`Call started: ${call.callId}`);

1
import { Voicebip, VoicebipError } from "@voicebip/sdk";
2
3
try {
4
  await client.calls.initiate({ ... });
5
} catch (err) {
6
  if (err instanceof VoicebipError) {
7
    console.error(`${err.errorCode}: ${err.message}`);
8
    // Handle specific errors
9
    if (err.errorCode === "CALL_WINDOW_RESTRICTED") {
10
      console.log("Call outside permitted hours");
11
    }
12
  }
13
}