Skift fra Twilio til volai på en eftermiddag.

Hvad svarer til hvad

Twilio SDK'et kan ikke blot pege på volai ved at skifte en adresse - det er et mindre og anderledes API. Begreberne svarer dog til hinanden én til én.

Kode side om side

Afsendelse af en SMS - samme idé, andet API.

const twilio = require("twilio");
const client = twilio(accountSid, authToken);

await client.messages.create({
  body: "Hi from Twilio!",
  from: "+15017122661",
  to: "+420777123456",
});

await fetch("https://volai.cz/v1/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer vk_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+420777123456",
    body: "Hi from volai!",
  }),
});

Twilio angiver afsenderen med feltet from. volai ignorerer from og vælger afsenderen med fromNumber (et nummer fra GET /v1/sms-numbers, tilvalget mobilnummer, eller fra GET /v1/voice-sms-numbers, nummer til opkald og sms). Uden fromNumber afsendes SMS'erne under det delte afsendernavn SMSinfo, som modtageren ikke kan svare til.

Giv det til din AI-agent

Kopiér prompten ind i Claude Code, Cursor eller en anden AI-editor, og lad den udføre migreringen for dig - SKILL.md giver den hele referencen.

Læs filen SKILL.md fra volais hjemmeside (API'ets basis-URL står i den). Find i mit projekt kaldene til Twilio SDK'et for SMS og opkald (client.messages.create, client.calls.create), og omskriv dem til volais REST API: POST /v1/messages for SMS, POST /v1/calls for opkald, header Authorization: Bearer vk_YOUR_KEY. Tilpas også håndteringen af webhooks til formatet fra SKILL.md, inklusive verifikation af headeren Volai-Signature.

Tjekliste til omskiftningen

1. 1

   Nummer

   Køb et tjekkisk nummer (POST /v1/numbers eller i portalen), og sæt dets routing - agent, videresendelse eller SIP. Til modtagelse af SMS og afsendelse fra dit eget nummer skal du desuden købe et mobilnummer (POST /v1/sms-numbers eller i portalen under Numre): et tjekkisk mobilnummer kun til SMS, uden opkald. Hvis du vil have opkald og SMS på det samme nummer, så bestil en nummer til opkald og sms i stedet for de to numre (POST /v1/voice-sms-numbers eller i portalen): en fastnetlinje i Prag, der efter bestillingen registreres hos operatøren, som regel inden for 1 hverdag. Opkald til den besvares kun af en agent på volais egen stemmemotor (den kan hverken dirigeres til SIP eller videresendes), så den egner sig ikke til en agent, der kører et andet sted.

2. 2

   Nøgle

   Opret en API-nøgle i portalen under AI-assistent.

3. 3

   Webhook

   Sæt webhooken (PUT /v1/webhook) til den samme adresse, som din Twilio StatusCallback bruger i dag, og tilpas håndteringen til den nye hændelsesform. Hvis adressen indeholder brugernavn og adgangskode, så flyt loginet over i en egen header (headers, fx Authorization: Basic ...); volai afviser en adresse med loginoplysninger.

4. 4

   Test

   Før du skifter den rigtige trafik, så send dig selv en SMS og ring et testopkald til din egen mobil.

5. 5

   DNS og gamle kontaktoplysninger

   DNS behøver du som regel ikke røre - volai bruger ikke dit domæne. Tjek dog websteder, e-mailsignaturer og dokumentation, hvor det gamle telefonnummer står skrevet ind direkte.

Hvornår du skal blive hos Twilio

Migrering er ikke for alle - ud over oversigten ovenfor bør du også overveje dette:

• Udgående opkald fra volai går kun til tjekkiske og slovakiske numre (+420, +421) - du kan ikke ringe til udlandet, heller ikke fra et tjekkisk nummer, du ejer.
• Du har brug for mere end 60 forespørgsler i minuttet - det er den fælles grænse for både REST API'et og MCP-serveren.