Prelazak s Twilija na volai u jednom popodnevu.

Što čemu odgovara

Twilio SDK se na volai ne spaja zamjenom adrese - to je manji, drukčiji API. Pojmovi se ipak mapiraju jedan na jedan.

Kod jedan uz drugi

Slanje SMS-a - ista ideja, drukčiji 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 postavlja pošiljatelja poljem from. volai ignorira polje from i pošiljatelja bira poljem fromNumber (broj iz GET /v1/sms-numbers, dodatak "mobilni broj", ili iz GET /v1/voice-sms-numbers, "broj za pozive i SMS"). Bez fromNumber SMS-ovi odlaze pod zajedničkim imenom SMSinfo, na koje primatelj ne može odgovoriti.

Prepustite to svom AI agentu

Kopirajte prompt u Claude Code, Cursor ili drugi AI editor i neka migraciju provede umjesto vas - SKILL.md mu daje cijelu referencu.

Pročitaj SKILL.md s weba volai (osnovni URL API-ja naveden je u njemu). Pronađi u mom projektu pozive Twilio SDK-a za SMS i pozive (client.messages.create, client.calls.create) i prepiši ih na REST API volai: POST /v1/messages za SMS, POST /v1/calls za pozive, zaglavlje Authorization: Bearer vk_VAS_KLJUC. Prilagodi i primanje webhookova formatu iz SKILL.md, uključujući provjeru zaglavlja Volai-Signature.

Popis za prebacivanje

1. 1

   Broj

   Kupite češki broj (POST /v1/numbers ili u portalu) i postavite mu usmjeravanje - agent, prosljeđivanje ili SIP. Za primanje SMS-a i slanje s vlastitog broja kupite još i dodatak "mobilni broj" (POST /v1/sms-numbers ili u portalu u Brojevima): češki broj samo za SMS, bez poziva. Ako želite pozive i SMS na jednom broju, umjesto dva broja naručite "broj za pozive i SMS" (POST /v1/voice-sms-numbers ili u portalu): praška fiksna linija koja se nakon narudžbe registrira kod operatera, obično u roku od 1 radnog dana. Pozive na nju podiže samo agent na vlastitom glasovnom pogonu volai (ne može se usmjeriti na SIP niti proslijediti), pa nije prikladna za agenta koji radi drugdje.

2. 2

   Ključ

   Generirajte API ključ u portalu u odjeljku AI asistent.

3. 3

   Webhook

   Postavite webhook (PUT /v1/webhook) na istu adresu na koju danas stiže Twilio StatusCallback i prilagodite obradu novom obliku događaja. Ako adresa u sebi sadrži korisničko ime i lozinku, prijavu prebacite u vlastito zaglavlje (headers, na primjer Authorization: Basic ...), jer volai odbija adresu s podacima za prijavu.

4. 4

   Test

   Prije nego što prebacite stvarni promet, pošaljite si SMS i nazovite testni poziv na vlastiti mobitel.

5. 5

   DNS i stari kontakti

   DNS obično ne morate mijenjati - volai ne koristi vašu domenu. Provjerite ipak web stranice, potpise e-pošte i dokumentaciju u kojima je stari telefonski broj upisan izravno.

Kada ostati kod Twilija

Migracija nije za svakoga - uz gornji pregled razmotrite i ovo:

• Odlazni pozivi iz volai idu samo na češke i slovačke brojeve (+420, +421) - na strani broj ne možete nazvati, ni s kupljenog češkog broja.
• Trebate veći opseg od 60 zahtjeva u minuti - to je zajedničko ograničenje REST API-ja i MCP poslužitelja.