Van Twilio naar volai migreren in één middag.

Wat waarmee overeenkomt

De Twilio SDK kunt u niet zomaar naar volai laten wijzen door een adres te wijzigen - het is een kleinere, andere API. De concepten komen wel één op één overeen.

Code naast elkaar

Een sms versturen - hetzelfde idee, een andere 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 bepaalt de afzender met het veld from. volai negeert from en kiest de afzender met fromNumber (een nummer uit GET /v1/sms-numbers, de add-on mobiel nummer, of uit GET /v1/voice-sms-numbers, de nummer voor bellen en sms). Zonder fromNumber gaan sms uit onder de gedeelde afzendernaam SMSinfo, waarop ontvangers niet kunnen antwoorden.

Geef het aan uw AI-agent

Kopieer de prompt naar Claude Code, Cursor of een andere AI-editor en laat de migratie door hem uitvoeren - SKILL.md geeft hem de volledige referentie.

Lees het bestand SKILL.md van volai (de link staat op deze pagina). Zoek in mijn project de Twilio SDK-aanroepen voor sms en gesprekken (client.messages.create, client.calls.create) en schrijf ze om naar de volai REST API: POST /v1/messages voor sms, POST /v1/calls voor gesprekken, met de basis-URL uit SKILL.md en de header Authorization: Bearer vk_YOUR_KEY. Pas ook de verwerking van webhooks aan naar het formaat in SKILL.md, inclusief de verificatie van de header Volai-Signature.

Checklist voor de overstap

1. 1

   Nummer

   Koop een Tsjechisch nummer (POST /v1/numbers of in het portaal) en stel de routering in - agent, doorschakelen of SIP. Voor het ontvangen van sms en het versturen vanaf uw eigen nummer koopt u ook een mobiel nummer (POST /v1/sms-numbers of in het portaal onder Nummers): een Tsjechisch mobiel nummer alleen voor sms, zonder gesprekken. Wilt u gesprekken en sms op hetzelfde nummer, bestel dan een nummer voor bellen en sms in plaats van de twee nummers (POST /v1/voice-sms-numbers of in het portaal): een vast nummer in Praag dat na uw bestelling bij de operator wordt geregistreerd, meestal binnen 1 werkdag. Gesprekken erop worden alleen door een agent op de eigen spraakengine van volai beantwoord (het kan niet naar SIP worden gerouteerd of doorgeschakeld), dus het past niet bij een agent die elders draait.

2. 2

   Sleutel

   Genereer een API-sleutel in het portaal, onder AI-assistent.

3. 3

   Webhook

   Stel de webhook (PUT /v1/webhook) in op hetzelfde adres dat uw Twilio StatusCallback nu gebruikt, en pas de handler aan voor de nieuwe vorm van de events. Als het adres een gebruikersnaam en wachtwoord bevat, verplaats de inloggegevens dan naar een eigen header (headers, bijvoorbeeld Authorization: Basic ...); volai weigert een adres met inloggegevens.

4. 4

   Test

   Stuur uzelf voordat u het live verkeer omzet een sms en plaats een testgesprek naar uw eigen telefoon.

5. 5

   DNS en oude contactgegevens

   Aan DNS hoeft u meestal niets te doen - volai gebruikt uw domein niet. Controleer wel websites, e-mailhandtekeningen en documentatie op het oude telefoonnummer dat handmatig is ingevoerd.

Wanneer u bij Twilio blijft

Migreren is niet voor iedereen - weeg naast het overzicht hierboven ook dit af:

• Uitgaande gesprekken van volai bereiken alleen Tsjechische en Slowaakse nummers (+420, +421) - u kunt niet naar het buitenland bellen, zelfs niet vanaf een Tsjechisch nummer dat u bezit.
• U hebt meer dan 60 verzoeken per minuut nodig - dat is de gedeelde limiet voor zowel de REST API als de MCP-server.