Přeskočit na obsah

Migrace

Přechod z Twilia na volai za jedno odpoledne.

Menší API, stejné pojmy. Mapování Twilio pojmů na volai, srovnání kódu vedle sebe, hotový prompt pro tvého AI agenta a checklist, co všechno přepnout.

Má to pro tebe smysl?

Ano, pokud potřebuješ

  • Česká telefonní čísla (+420) a lokální hovorné.
  • Hlasového agenta hotového z krabice, ne stavěného z audio streamů a vlastního modelu.
  • Fakturaci v korunách bez kurzových překvapení na výpisu z karty.

Zůstaň u Twilia, pokud potřebuješ

  • Příjem SMS do API - volai zatím umí jen odesílat.
  • Telefonní čísla mimo Českou republiku.
  • WhatsApp, video nebo další komunikační kanály.

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é.

Twiliovolai
Account SID + Auth TokenAPI klíč vk_...
Messages resourcePOST /v1/messages
Calls resourcePOST /v1/calls
IncomingPhoneNumbersGET a POST /v1/numbers
StatusCallbackwebhook události
TwiMLhlasový agent (systemPrompt)
X-Twilio-SignatureVolai-Signature

Kód vedle sebe

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

Twilio (Node.js SDK)

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

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

volai (fetch)

javascript
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!",
  }),
});

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.

text
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. Číslo

    Kup české číslo (POST /v1/numbers nebo v portálu) a nastav mu routing - agent, přeposílání, nebo SIP.

  2. Klíč

    Vygeneruj API klíč v portálu v sekci API a MCP.

  3. Webhook

    Nastav webhook (PUT /v1/webhook) na stejnou adresu, kam dnes chodí Twilio StatusCallback, a uprav zpracování na nový tvar události.

  4. Test

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

  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.

Začni migraci

Registrace trvá minutu a prvních 50 Kč kreditu je od nás - vyzkoušej si nové API dřív, než přepneš ostrý provoz.