Trecerea de la Twilio la volai într-o după-amiază.

Ce corespunde cu ce

SDK-ul Twilio nu se conectează la volai prin simpla schimbare a adresei - este un API mai mic și diferit. Conceptele se potrivesc însă unu la unu.

Codul unul lângă altul

Trimiterea unui SMS - aceeași idee, alt 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 setează expeditorul prin câmpul from. volai ignoră câmpul from și alege expeditorul prin câmpul fromNumber (un număr din GET /v1/sms-numbers, add-onul număr de mobil, sau din GET /v1/voice-sms-numbers, număr pentru apeluri și SMS). Fără fromNumber, SMS-urile pleacă sub numele partajat SMSinfo, la care destinatarul nu poate răspunde.

Dați-i sarcina agentului dumneavoastră AI

Copiați promptul în Claude Code, Cursor sau în alt editor AI și lăsați-l să facă migrarea în locul dumneavoastră - SKILL.md îi oferă întreaga referință.

Citește fișierul SKILL.md de pe site-ul volai (URL-ul de bază al API-ului se află în el). Găsește în proiectul meu apelurile SDK-ului Twilio pentru SMS și apeluri (client.messages.create, client.calls.create) și rescrie-le pentru API-ul REST volai: POST /v1/messages pentru SMS, POST /v1/calls pentru apeluri, antetul Authorization: Bearer vk_YOUR_KEY. Adaptează și primirea webhookurilor la formatul din SKILL.md, inclusiv verificarea antetului Volai-Signature.

Lista de verificare a trecerii

1. 1

   Număr

   Cumpărați un număr ceh (POST /v1/numbers sau în portal) și setați-i rutarea - agent, redirecționare sau SIP. Pentru primirea SMS-urilor și trimiterea de la numărul propriu, cumpărați și un număr de mobil (POST /v1/sms-numbers sau în portal, la Numere): un număr mobil ceh doar pentru SMS, fără apeluri. Dacă doriți apeluri și SMS pe un singur număr, comandați în loc de două numere un număr pentru apeluri și SMS (POST /v1/voice-sms-numbers sau în portal): o linie fixă din Praga care se înregistrează la operator după comandă, de obicei în cel mult o zi lucrătoare. Apelurile către ea le preia doar agentul de pe motorul vocal propriu al volai (nu poate fi direcționată către SIP și nici redirecționată), deci nu este potrivită pentru un agent care rulează în altă parte.

2. 2

   Cheie

   Generați o cheie API în portal, în secțiunea Asistent AI.

3. 3

   Webhook

   Setați webhookul (PUT /v1/webhook) la aceeași adresă la care vă ajunge acum StatusCallback de la Twilio și adaptați procesarea la noua formă a evenimentului. Dacă adresa conține nume și parolă, mutați autentificarea într-un antet propriu (headers, de exemplu Authorization: Basic ...); o adresă cu date de autentificare este respinsă de volai.

4. 4

   Test

   Înainte de a comuta traficul real, trimiteți-vă un SMS și efectuați un apel de probă către propriul telefon mobil.

5. 5

   DNS și contactele vechi

   De regulă nu trebuie să schimbați DNS-ul - volai nu folosește domeniul dumneavoastră. Verificați însă site-urile, semnăturile de e-mail și documentația în care vechiul număr de telefon este scris direct în text.

Când să rămâneți la Twilio

Migrarea nu este pentru toată lumea - pe lângă prezentarea de mai sus, luați în calcul și acestea:

• Apelurile efectuate din volai merg doar către numere cehe și slovace (+420, +421) - nu puteți suna un număr din străinătate, nici de pe un număr ceh cumpărat.
• Aveți nevoie de un volum mai mare de 60 de cereri pe minut - aceasta este limita comună a API-ului REST și a serverului MCP.