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é.
| Twilio | volai |
|---|---|
| Account SID + Auth Token | API klíč vk_... |
| Messages resource | POST /v1/messages |
| Calls resource | POST /v1/calls |
| IncomingPhoneNumbers | GET a POST /v1/numbers |
| StatusCallback | webhook události |
| TwiML | hlasový agent (systemPrompt) |
| X-Twilio-Signature | Volai-Signature |
Kód vedle sebe
Odeslání SMS - stejná myšlenka, jiné API.
Twilio (Node.js SDK)
const twilio = require("twilio");
const client = twilio(accountSid, authToken);
await client.messages.create({
body: "Ahoj z Twilia!",
from: "+15017122661",
to: "+420777123456",
});volai (fetch)
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.
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í
Číslo
Kup české číslo (POST /v1/numbers nebo v portálu) a nastav mu routing - agent, přeposílání, nebo SIP.
Klíč
Vygeneruj API klíč v portálu v sekci API a MCP.
Webhook
Nastav webhook (PUT /v1/webhook) na stejnou adresu, kam dnes chodí Twilio StatusCallback, a uprav zpracování na nový tvar události.
Test
Než přepneš ostrý provoz, pošli si SMS a zavolej testovací hovor na vlastní mobil.
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.