Migratsioon
Üleminek Twiliost volai peale ühe pärastlõunaga.
Väiksem API, samad mõisted. Twilio mõistete vastavus volai omadele, koodi kõrvuti võrdlus, valmis viip teie AI-agendile ja kontrollnimekiri, mida kõike ümber lülitada.
Kas see on teile mõttekas?
Jah, kui vajate
- Tšehhi telefoninumbreid (+420) ja kohalikke kõnetariife.
- Karbist välja valmis häälagenti, mitte helivoogudest ja oma mudelist ehitatut.
- Saldot, mida ostate oma riigi vääringus, ilma vahetuskursi üllatusteta kaardiväljavõttel.
- Kõnesid ja SMS-e samal Tšehhi numbril - Twilios oskab Tšehhi number kas kõnesid või SMS-e, volai pakub number kõnede ja SMS-ide jaoks (Praha püsiliini).
Jääge Twilio juurde, kui vajate
- Rohkem numbreid SMS-ide vastuvõtuks, kui konto piirangud lubavad, või SMS-ide vastuvõttu teistes riikides - volai häälnumbrid SMS-e vastu ei võta ja SMS-e oskavad vastu võtta mobiilinumber (Tšehhi mobiilinumber ainult SMS-ide jaoks) ja number kõnede ja SMS-ide jaoks (Praha püsiliin), kumbagi liiki kuni kaks konto kohta; teenuste kinnituskoode me ei garanteeri.
- Telefoninumbreid väljaspool volai pakkumist: Tšehhi, Slovaki Bratislava suunakoodiga ja praeguse pakkumise riikide numbrid, viimased ainult kõnede jaoks, ilma SMS-ideta ja helistamisega ainult numbri riiki ning Tšehhi.
- WhatsAppi, videot või muid suhtluskanaleid.
Mis millele vastab
Twilio SDK-d volai külge aadressi vahetamisega ei ühenda - see on väiksem, teistsugune API. Mõisted aga vastavad üks-ühele.
| Twilio | volai |
|---|---|
| Account SID + Auth Token | API võti vk_... |
| Messages resource | POST /v1/messages |
| From (saatja number) | fromNumber (mobiilinumbri lisand või number kõnede ja SMS-ide jaoks) |
| Calls resource | POST /v1/calls |
| IncomingPhoneNumbers | GET ja POST /v1/numbers (mobiilinumbrid: GET ja POST /v1/sms-numbers; number kõnede ja SMS-ide jaoks numbrid: GET ja POST /v1/voice-sms-numbers) |
| Sissetuleva sõnumi veebikonks (SmsUrl) | sündmus message.received |
| StatusCallback | sündmuste veebikonks |
| TwiML | häälagent (systemPrompt) |
| X-Twilio-Signature | Volai-Signature |
Kood kõrvuti
SMS-i saatmine - sama mõte, teine API.
Twilio (Node.js SDK)
const twilio = require("twilio");
const client = twilio(accountSid, authToken);
await client.messages.create({
body: "Hi from Twilio!",
from: "+15017122661",
to: "+420777123456",
});volai (fetch)
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 määrab saatja väljaga from. volai ignoreerib välja from ja valib saatja väljaga fromNumber (number kutsest GET /v1/sms-numbers, mobiilinumbri lisand, või kutsest GET /v1/voice-sms-numbers, number kõnede ja SMS-ide jaoks). Ilma fromNumber-ita lähevad SMS-id jagatud nime SMSinfo all, millele saaja vastata ei saa.
Andke see oma AI-agendile
Kopeerige viip Claude Code'i, Cursorisse või mõnda muusse AI-redaktorisse ja laske tal migratsioon teie eest teha - SKILL.md annab talle kogu viite.
Loe volai veebilehelt faili SKILL.md (selles on API baas-URL). Leia minu projektist Twilio SDK kutsed SMS-ide ja kõnede jaoks (client.messages.create, client.calls.create) ja kirjuta need ümber volai REST API peale: POST /v1/messages SMS-ide jaoks, POST /v1/calls kõnede jaoks, päis Authorization: Bearer vk_YOUR_KEY. Kohanda ka veebikonksude vastuvõtt vormingule failist SKILL.md, sealhulgas päise Volai-Signature kontroll.Ümberlülitamise kontrollnimekiri
Number
Ostke Tšehhi number (POST /v1/numbers või portaalis) ja seadistage selle marsruutimine - agent, edastamine või SIP. SMS-ide vastuvõtuks ja oma numbrilt saatmiseks ostke lisaks mobiilinumber (POST /v1/sms-numbers või portaalis jaotises Numbrid): Tšehhi mobiilinumber ainult SMS-ide jaoks, ilma kõnedeta. Kui soovite kõnesid ja SMS-e samal numbril, tellige kahe numbri asemel number kõnede ja SMS-ide jaoks (POST /v1/voice-sms-numbers või portaalis): Praha püsiliin, mis registreeritakse pärast tellimust operaatori juures, tavaliselt 1 tööpäeva jooksul. Kõnesid sellele võtab vastu ainult agent volai oma häälmootoril (seda SIP-ile suunata ega edasi suunata ei saa), seega ei sobi see agendile, mis töötab mujal.
Võti
Looge API võti portaalis jaotises AI assistent.
Veebikonks
Seadistage veebikonks (PUT /v1/webhook) samale aadressile, kuhu tuleb praegu Twilio StatusCallback, ja kohandage töötlus uuele sündmuse kujule. Kui aadress sisaldab kasutajanime ja parooli, viige sisselogimine kohandatud päisesse (headers, näiteks Authorization: Basic ...), volai lükkab sisselogimisandmetega aadressi tagasi.
Test
Enne tegeliku liikluse ümberlülitamist saatke endale SMS ja tehke proovikõne oma mobiilile.
DNS ja vanad kontaktid
DNS-i tavaliselt muutma ei pea - volai ei kasuta teie domeeni. Kontrollige aga veebilehti, e-posti allkirju ja dokumentatsiooni, kuhu on vana telefoninumber kirjutatud kõvakodeeritult.
Millal jääda Twilio juurde
Migratsioon ei pruugi sobida kõigile - lisaks ülaltoodud ülevaatele kaaluge ka seda:
- Väljaminevad kõned volai-st lähevad ainult Tšehhi ja Slovaki numbritele (+420, +421) - välisnumbrile ei helista te läbi, isegi mitte ostetud Tšehhi numbrilt.
- Vajate suuremat mahtu kui 60 päringut minutis - see on REST API ja MCP serveri ühine piirang.
Alustage migratsiooni
Registreerumine võtab minuti ja esimesed 50 kr saldot on meilt - proovige uut API-t enne, kui tegeliku liikluse ümber lülitate.