Prehod s Twilia na volai v enem popoldnevu.

Kaj čemu ustreza

Twilio SDK se na volai ne poveže z zamenjavo naslova - je manjši, drugačen API. Pojmi pa se preslikajo ena na ena.

Koda drugo ob drugem

Pošiljanje SMS - ista zamisel, drugačen 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 nastavi pošiljatelja s poljem from. volai polje from prezre in pošiljatelja izbere s poljem fromNumber (številka iz GET /v1/sms-numbers, dodatek mobilna številka, ali iz GET /v1/voice-sms-numbers, številka za klice in SMS). Brez fromNumber SMS odhajajo pod skupnim imenom SMSinfo, na katerega prejemnik ne more odgovoriti.

Dajte to svojemu AI agentu

Kopirajte navodilo v Claude Code, Cursor ali drug AI urejevalnik in mu prepustite migracijo - SKILL.md mu da celotno referenco.

Preberi datoteko SKILL.md storitve volai (povezava je spodaj, pod SKILL.md za agente). Poišči v mojem projektu klice Twilio SDK za SMS in klice (client.messages.create, client.calls.create) in jih prepiši na REST API volai: POST /v1/messages za SMS, POST /v1/calls za klice, glava Authorization: Bearer vk_VAS_KLJUC, osnovni naslov API-ja vzemi iz SKILL.md. Prilagodi tudi sprejem webhookov obliki iz SKILL.md, vključno s preverjanjem glave Volai-Signature.

Kontrolni seznam preklopa

1. 1

   Številka

   Kupite češko številko (POST /v1/numbers ali v portalu) in ji nastavite usmerjanje - agent, posredovanje ali SIP. Za sprejem SMS in pošiljanje z lastne številke kupite še mobilno številko (POST /v1/sms-numbers ali v portalu v Številkah): češka mobilna številka samo za SMS, brez klicev. Če želite klice in SMS na eni številki, namesto dveh številk naročite številka za klice in SMS (POST /v1/voice-sms-numbers ali v portalu): praško stacionarno linijo, ki se po naročilu registrira pri operaterju, običajno v 1 delovnem dnevu. Klice nanjo dviga samo agent na lastnem glasovnem motorju volai (usmeriti je na SIP ali posredovati ni mogoče), zato ni primerna za agenta, ki teče drugje.

2. 2

   Ključ

   Ustvarite API ključ v portalu v razdelku AI asistent.

3. 3

   Webhook

   Nastavite webhook (PUT /v1/webhook) na isti naslov, kamor danes prihaja Twilio StatusCallback, in prilagodite obdelavo novi obliki dogodka. Če ima naslov v sebi uporabniško ime in geslo, prijavo prestavite v lastno glavo (headers, na primer Authorization: Basic ...), naslov s prijavnimi podatki volai zavrne.

4. 4

   Preizkus

   Preden preklopite ostri promet, si pošljite SMS in pokličite preizkusni klic na lasten mobilni telefon.

5. 5

   DNS in stari stiki

   DNS običajno ni treba spreminjati - volai ne uporablja vaše domene. Preverite pa spletišča, e-poštne podpise in dokumentacijo, kjer je stara telefonska številka zapisana trdo.

Kdaj ostati pri Twiliu

Migracija ni nujno za vsakogar - poleg zgornjega pregleda premislite tudi o tem:

• Odhodni klici iz volai gredo samo na češke in slovaške številke (+420, +421) - na tujo številko ne morete poklicati, niti s kupljene češke številke.
• Potrebujete večji obseg kot 60 zahtev na minuto - to je skupna omejitev REST API-ja in strežnika MCP.