Prechod z Twilia na volai za jedno popoludnie.

Čo čomu zodpovedá

Twilio SDK sa na volai nenapojí výmenou adresy - je to menšie, iné API. Pojmy sa však mapujú jedna k jednej.

Kód vedľa seba

Odoslanie SMS - rovnaká myšlienka, iné 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 nastavuje odosielateľa poľom from. volai pole from ignoruje a odosielateľa vyberá poľom fromNumber (číslo z GET /v1/sms-numbers, doplnok mobilné číslo, alebo z GET /v1/voice-sms-numbers, číslo pre hovory aj SMS). Bez fromNumber odchádzajú SMS pod zdieľaným menom SMSinfo, na ktoré príjemca nemôže odpovedať.

Dajte to svojmu AI agentovi

Skopírujte prompt do Claude Code, Cursoru alebo iného AI editora a nechajte ho migráciu vykonať za Vás - SKILL.md mu dá celú referenciu.

Prečítaj si SKILL.md z webu volai (základná URL API je uvedená v ňom). Nájdi v mojom projekte volania Twilio SDK pre SMS a hovory (client.messages.create, client.calls.create) a prepíš ich na REST API volai: POST /v1/messages pre SMS, POST /v1/calls pre hovory, hlavička Authorization: Bearer vk_VAS_KLUC. Uprav aj príjem webhookov na formát zo SKILL.md vrátane overenia hlavičky Volai-Signature.

Checklist prepnutia

1. 1

   Číslo

   Kúpte české číslo (POST /v1/numbers alebo v portáli) a nastavte mu routing - agent, preposielanie, alebo SIP. Na príjem SMS a odosielanie z vlastného čísla kúpte ešte mobilné číslo (POST /v1/sms-numbers alebo v portáli v Číslach): české mobilné číslo len pre SMS, bez hovorov. Ak chcete mať hovory aj SMS na jednom čísle, objednajte namiesto dvoch čísel číslo pre hovory aj SMS (POST /v1/voice-sms-numbers alebo v portáli): pražskú pevnú linku, ktorá sa po objednávke registruje u operátora, zvyčajne do 1 pracovného dňa. Hovory na ňu zdvíha len agent na vlastnom hlasovom motore volai (nasmerovať ju na SIP ani preposlať sa nedá), takže sa nehodí pre agenta, ktorý beží inde.

2. 2

   Kľúč

   Vygenerujte API kľúč v portáli v sekcii AI asistent.

3. 3

   Webhook

   Nastavte webhook (PUT /v1/webhook) na rovnakú adresu, kam dnes chodí Twilio StatusCallback, a upravte spracovanie na nový tvar udalosti. Ak má adresa v sebe meno a heslo, presuňte prihlasovanie do vlastnej hlavičky (headers, napríklad Authorization: Basic ...), adresu s prihlasovacími údajmi volai odmietne.

4. 4

   Test

   Skôr než prepnete ostrú prevádzku, pošlite si SMS a zavolajte testovací hovor na vlastný mobil.

5. 5

   DNS a staré kontakty

   DNS zvyčajne meniť nemusíte - volai nepoužíva Vašu doménu. Skontrolujte však weby, e-mailové podpisy a dokumentáciu, kde je staré telefónne číslo napísané natvrdo.

Kedy zostať pri Twiliu

Migrácia nemusí byť pre každého - okrem prehľadu vyššie zvážte aj toto:

• Odchádzajúce hovory z volai idú len na české a slovenské čísla (+420, +421) - na zahraničné číslo sa nedovoláte, ani z Vášho českého čísla.
• Potrebujete vyšší objem než 60 požiadaviek za minútu - to je spoločný limit REST API aj MCP servera.