Přechod z Twilia na volai za jedno odpoledne.

Co čemu odpovídá

Twilio SDK se na volai nenapojí výměnou adresy - je to menší, jiné API. Pojmy se ale mapují jedna ku jedné.

Kód vedle sebe

Odeslání SMS - stejná myšlenka, jiné API.

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

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

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

Twilio nastavuje odesílatele polem from. volai pole from ignoruje a odesílatele vybírá polem fromNumber (číslo z GET /v1/sms-numbers, doplněk SMS číslo, nebo z GET /v1/voice-sms-numbers, číslo pro hovory i SMS). Bez fromNumber odcházejí SMS pod sdíleným jménem SMSinfo, na které příjemce neodpoví.

Dej to svému AI agentovi

Zkopíruj prompt do Claude Code, Cursoru nebo jiného AI editoru a nech ho migraci provést za tebe - SKILL.md mu dá celou referenci.

Přečti si https://volai.cz/SKILL.md. Najdi v mém projektu volání Twilio SDK pro SMS a hovory (client.messages.create, client.calls.create) a přepiš je na REST API volai: POST https://volai.cz/v1/messages pro SMS, POST https://volai.cz/v1/calls pro hovory, hlavička Authorization: Bearer vk_TVUJ_KLIC. Uprav i příjem webhooků na formát z SKILL.md včetně ověření hlavičky Volai-Signature.

Checklist přepnutí

1. 1

   Číslo

   Kup české číslo (POST /v1/numbers nebo v portálu) a nastav mu routing - agent, přeposílání, nebo SIP. Pro příjem SMS a odesílání z vlastního čísla kup ještě SMS číslo (POST /v1/sms-numbers nebo v portálu v Číslech): české mobilní číslo jen pro SMS, bez hovorů. Chceš-li mít hovory i SMS na jednom čísle, objednej místo dvou čísel číslo pro hovory i SMS (POST /v1/voice-sms-numbers nebo v portálu): pražskou pevnou linku, která se po objednávce registruje u operátora, obvykle do 1 pracovního dne. Hovory na ni zvedá jen agent na vlastním hlasovém motoru volai (nasměrovat ji na SIP ani přeposlat nejde), takže se nehodí pro agenta, který běží jinde.

2. 2

   Klíč

   Vygeneruj API klíč v portálu v sekci AI asistent.

3. 3

   Webhook

   Nastav webhook (PUT /v1/webhook) na stejnou adresu, kam dnes chodí Twilio StatusCallback, a uprav zpracování na nový tvar události. Má-li adresa v sobě jméno a heslo, přesuň přihlášení do vlastní hlavičky (headers, například Authorization: Basic ...), adresu s přihlašovacími údaji volai odmítne.

4. 4

   Test

   Než přepneš ostrý provoz, pošli si SMS a zavolej testovací hovor na vlastní mobil.

5. 5

   DNS a staré kontakty

   DNS obvykle měnit nemusíš - volai nepoužívá tvou doménu. Zkontroluj ale weby, e-mailové podpisy a dokumentaci, kde je staré telefonní číslo napsané natvrdo.

Kdy zůstat u Twilia

Migrace nemusí být pro každého - kromě přehledu výše zvaž i tohle:

• Odchozí hovory z volai jdou jen na česká a slovenská čísla (+420, +421) - na zahraniční číslo se nedovoláš, ani z koupeného českého čísla.
• Potřebuješ vyšší objem než 60 požadavků za minutu - to je společný limit REST API i MCP serveru.