​

Voice Quickstart

• A phone number that receives inbound calls
• An agent configured with a system prompt
• An inbound call from any phone reaching your agent
• An outbound call dispatched from the API

​

Step 1: Provision a number (60 seconds)

1. Open your dashboard at orbit.devotel.io.
2. From the home page, click Claim a trial number in the onboarding card. (Already past onboarding? Open Numbers → Buy and pick Use a trial number at the top of the list.)
3. The dashboard assigns one number from the pool and lists it under Numbers. Note the E.164 form — e.g. +14155551234.

​

Step 2: Configure an agent (90 seconds)

1. Open Agents → New agent.
2. Pick a name, leave the type as voice (or chatbot — voice works with any agent type as long as a system prompt is set).
3. Paste a starter system prompt:
   You are a helpful customer-support assistant for Acme Inc.
   Greet callers, answer questions about order status and returns,
   and escalate anything billing-related by saying "let me transfer
   you to a billing specialist".
   
4. Save. Your agent now has a stable ID like agt_abc123.
5. Click Test by voice (the second pill next to “Test by chat” in Agent Studio). Grant mic permission, talk to the agent in the browser, and confirm the system prompt is doing what you expect before you wire it to a real number. The browser-mic test reuses the same Orbit Media + Deepgram + Cartesia pipeline that the PSTN path uses, so anything that works here will work on a real call.

​

Step 3: Route inbound calls to the agent (45 seconds)

1. Open Numbers, click your trial (or purchased) number.
2. Under Inbound routing, pick AI agent.
3. Select the agent you just saved.
4. Save.

​

Step 4: Receive your first call

1. Answers the call
2. Streams audio through Deepgram for live STT
3. Routes the user-message transcript to the agent
4. Streams the agent’s reply through Cartesia TTS back to the caller — with barge-in detection so the caller can interrupt long replies naturally

​

Step 5: Dispatch an outbound call from the API

curl -X POST https://api.orbit.devotel.io/api/v1/voice/calls \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+14155551234",
    "agent_id": "agt_abc123"
  }'

​

Node SDK

npm install @devotel/orbit-sdk

import { Orbit } from "@devotel/orbit-sdk";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY! });

const call = await orbit.voice.calls.create({
  to: "+14155552671",
  from: "+14155551234",
  agent_id: "agt_abc123",
});

console.log(call.id);

​

Step 6: Subscribe to call events (optional)

​

Call-lifecycle events (webhooks)

​

Live transcript (per-call SSE)

// 1. Mint a 60s single-use ticket for this call.
const { ticket } = await fetch(
  `https://api.orbit.devotel.io/api/v1/voice/calls/${callId}/transcript/ticket`,
  { method: "POST", headers: { "X-API-Key": apiKey } },
).then((r) => r.json());

// 2. Open the per-call transcript SSE stream with the ticket.
const evt = new EventSource(
  `https://api.orbit.devotel.io/api/v1/voice/calls/${callId}/transcript/stream?ticket=${ticket}`,
);

evt.addEventListener("transcript", (e) =>
  console.log("transcript", JSON.parse(e.data)),
);

​

Language coverage

​

Common next steps

• Add knowledge: attach a knowledge base to your agent so it can answer FAQ-style questions grounded in your docs. See AI Agents → Creating Agents.
• Handoffs: route specific intents (billing, returns, sales) to different agents or to a human queue. See Handoff Targets.
• Cost controls: set a daily spend cap so a misbehaving prompt can’t blow through your wallet. See Cost Controls.
• Production numbers: buy a dedicated DID from Numbers → Buy when you’re ready to leave the trial pool. Numbers in regulated countries (US, DE, FR, …) may require a compliance bundle — the dashboard surfaces the required steps inline.

​

Cross-references

• Text-message quickstart: Quickstart
• Voice channel reference: Channels → Voice
• Voice API reference: API → Voice & Numbers