Starter examples

​

Run any of them in 5 minutes

1. Create a free account at orbit.devotel.io/signup.
2. In Settings > API Keys, create a Test key (prefixed dv_test_sk_). Sandbox sends are simulated — free, instant, and they never reach a real carrier.
3. cd into a starter, copy .env.example to .env, paste your key, and follow that repo’s README.

​

OTP sign-in in Next.js 15 (orbit-otp-nextjs)

npm install
cp .env.example .env      # then paste your Orbit API key
npm run dev

export function sendOtp(to: string, channel: OtpChannel) {
  return orbitPost<VerifySendResult>("/verify/send", {
    to,
    channel,
    code_length: 6,
  });
}

1. POST /verify/send with { to, channel, code_length } — the response data carries the pending verification:
   {
     "verification_id": "vrf_3f1c0b2a8e4d4f7a9c2b1e6d5a4c3b2a",
     "status": "pending",
     "channel": "sms",
     "expires_at": "2026-08-24T12:10:00.000Z"
   }
   
2. POST /verify/check with the verification_id and the code the user entered (the second helper in src/lib/orbit.ts):
   export function checkOtp(verificationId: string, code: string) {
     return orbitPost<VerifyCheckResult>("/verify/check", {
       verification_id: verificationId,
       code,
     });
   }
   
   A correct, unexpired code completes the round trip with an approved result — a wrong code surfaces in the error envelope with the attempts remaining, not a 200:
   {
     "verification_id": "vrf_3f1c0b2a8e4d4f7a9c2b1e6d5a4c3b2a",
     "status": "approved",
     "channel": "sms"
   }
   

• Docs: Verify
• Repo: orbit-otp-nextjs

​

WhatsApp chatbot (whatsapp-chatbot-starter)

npm install
cp .env.example .env      # add your API key and webhook signing secret
npm start

event = constructEvent(payload, signature, ORBIT_WEBHOOK_SECRET);
// ...acknowledge the webhook, then:
await orbit.messages.sendWhatsApp({
  to: from,
  type: "text",
  text: { body: replyTo(text) },
});

1. Inbound — Orbit delivers a signed message.received event. Read the raw body, verify the signature, then parse it. The event shape:
   {
     "type": "message.received",
     "created_at": "2026-08-24T12:00:00.000Z",
     "data": {
       "channel": "whatsapp",
       "from": "+14155552671",
       "to": "+12125559876",
       "body": "hours"
     }
   }
   
2. Outbound — the bot replies with messages.sendWhatsApp (shown above) and gets back the queued message:
   {
     "id": "msg_9a2f7c1e4b8d4e3a9f1b6c2d",
     "channel": "whatsapp",
     "status": "sent"
   }
   

• Docs: WhatsApp
• Repo: whatsapp-chatbot-starter

​

AI voice agent (ai-voice-agent-quickstart)

npm install
cp .env.example .env      # add your Orbit API key
npm start

const { data: agent } = await orbit.agents.create({
  name: "Orbit Quickstart Voice Agent",
  system_prompt: "You are Robin, the friendly voice receptionist for Acme Inc. ...",
});
await orbit.agents.deploy(agent.id);
const { data: call } = await orbit.voice.calls.create({
  to: VOICE_TO,
  from: VOICE_FROM,
  agent_id: agent.id,
});

1. agents.create — the persona in, the new agent out:
   const { data: agent } = await orbit.agents.create({
     name: "Orbit Quickstart Voice Agent",
     system_prompt: "You are Robin, the friendly voice receptionist for Acme Inc. ...",
   });
   // → { id: "agt_7e3b9c1f...", status: "draft", ... }
   
2. agents.deploy(agent.id) — flips the agent’s status to active so it can take live interactions.
3. voice.calls.create — place the call the agent answers:
   const { data: call } = await orbit.voice.calls.create({
     to: VOICE_TO,
     from: VOICE_FROM,
     agent_id: agent.id,
   });
   // → { id: "call_4f1a8d2c...", status: "ringing", ... }
   

• Docs: Voice quickstart
• Repo: ai-voice-agent-quickstart

​

Transactional SMS notifications (orbit-sms-notifications-node)

npm install
cp .env.example .env      # add your Orbit API key
npm run send -- "+14155552671" "Your Acme order #1024 has shipped."

const { data: message } = await orbit.messages.sendSms({
  to,
  body,
});
console.log(`Sent SMS ${message.id} — status: ${message.status}`);

{
  "type": "message.delivered",
  "created_at": "2026-08-24T12:00:04.000Z",
  "data": {
    "id": "msg_9a2f7c1e4b8d4e3a9f1b6c2d",
    "channel": "sms",
    "to": "+14155552671"
  }
}

• Docs: SMS
• Repo: orbit-sms-notifications-node

​

Two-way SMS autoresponder (orbit-sms-autoresponder-node)

npm install
cp .env.example .env      # add your API key and webhook signing secret
npm start

event = constructEvent(payload, signature, ORBIT_WEBHOOK_SECRET);
// ...acknowledge the webhook, then:
await orbit.messages.sendSms({
  to: from,
  body: replyTo(text),
});

{
  "type": "message.received",
  "created_at": "2026-08-24T12:00:00.000Z",
  "data": {
    "channel": "sms",
    "from": "+14155552671",
    "body": "BALANCE"
  }
}

• Docs: Webhooks
• Repo: orbit-sms-autoresponder-node

​

Next steps

• Quickstart — create a key and make your first API call.
• SDKs — typed clients for Node, Python, Go, and more; the Node SDK used by four of the starters is @devotel-orbit/node.
• Webhook consumer guide — retries, idempotency, and signature verification pattern used by the webhook-based starters.
• Go-live checklist — what changes when you swap a Test key for a live one.