Pāriet uz saturu

Migrācija

Pāreja no Twilio uz volai vienā pēcpusdienā.

Mazāks API, tie paši jēdzieni. Twilio jēdzienu atbilstības volai, koda salīdzinājums blakus, gatavs uzdevums jūsu AI aģentam un kontrolsaraksts ar visu, kas jāpārslēdz.

Vai tas ir piemērots jums?

Jā, ja jums vajag

  • Čehijas tālruņa numurus (+420) un vietējos zvanu tarifus.
  • Balss aģentu, kas darbojas uzreiz, nevis tiek būvēts no audio straumēm un paša modeļa.
  • Kredītu, ko pērkat jūsu valsts valūtā, bez valūtas kursa pārsteigumiem kartes izrakstā.
  • Zvanus un SMS uz viena Čehijas numura - Twilio Čehijas numurs prot vai nu zvanus, vai SMS, savukārt volai piedāvā numurs zvaniem un SMS (Prāgas fiksēto numuru).

Paliekiet pie Twilio, ja jums vajag

  • Vairāk numuru SMS saņemšanai, nekā ļauj konta ierobežojumi, vai SMS saņemšanu citās valstīs - volai balss numuri SMS nesaņem, bet SMS spēj saņemt mobilais numurs (Čehijas numurs tikai SMS) un numurs zvaniem un SMS (Prāgas fiksētais numurs), no katra veida ne vairāk kā divi uz kontu; pakalpojumu verifikācijas kodus negarantējam.
  • Tālruņa numurus ārpus volai piedāvājuma: čehu, slovāku ar Bratislavas kodu un numurus valstīs no pašreizējā piedāvājuma, kas paredzēti tikai zvaniem, bez SMS un ar zvaniem tikai uz numura valsti un uz Čehiju.
  • WhatsApp, video vai citus saziņas kanālus.

Kas kam atbilst

Twilio SDK ar volai nesavienosies, vienkārši nomainot adresi - tas ir mazāks, citāds API. Taču jēdzieni atbilst viens pret vienu.

Twiliovolai
Account SID + Auth TokenAPI atslēga vk_...
Messages resourcePOST /v1/messages
From (sūtītāja numurs)fromNumber (mobilā numura papildinājums vai numurs zvaniem un SMS)
Calls resourcePOST /v1/calls
IncomingPhoneNumbersGET un POST /v1/numbers (mobilie numuri: GET un POST /v1/sms-numbers; numurs zvaniem un SMS: GET un POST /v1/voice-sms-numbers)
Ienākošās ziņas webhook (SmsUrl)notikums message.received
StatusCallbacknotikumu webhook
TwiMLbalss aģents (systemPrompt)
X-Twilio-SignatureVolai-Signature

Kods blakus

SMS sūtīšana - tā pati ideja, cits API.

Twilio (Node.js SDK)

javascript
const twilio = require("twilio");
const client = twilio(accountSid, authToken);

await client.messages.create({
  body: "Hi from Twilio!",
  from: "+15017122661",
  to: "+420777123456",
});

volai (fetch)

javascript
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 sūtītāju iestata ar lauku from. volai lauku from ignorē un sūtītāju izvēlas ar lauku fromNumber (numurs no GET /v1/sms-numbers, mobilā numura papildinājums, vai no GET /v1/voice-sms-numbers, numurs zvaniem un SMS). Bez fromNumber SMS tiek sūtītas ar kopīgo sūtītāja vārdu SMSinfo, uz kuru saņēmējs nevar atbildēt.

Iedodiet to savam AI aģentam

Nokopējiet uzdevumu uz Claude Code, Cursor vai citu AI redaktoru un ļaujiet tam veikt migrāciju jūsu vietā - SKILL.md tam dod pilnu atsauci.

text
Izlasi volai vietnes failu SKILL.md (API bāzes URL ir tajā). Atrodi manā projektā Twilio SDK izsaukumus SMS un zvaniem (client.messages.create, client.calls.create) un pārraksti tos uz volai REST API: POST /v1/messages SMS, POST /v1/calls zvaniem, galvene Authorization: Bearer vk_YOUR_KEY. Pielāgo arī webhook apstrādi formātam no SKILL.md, ieskaitot galvenes Volai-Signature pārbaudi.

Pārslēgšanas kontrolsaraksts

  1. Numurs

    Nopērciet Čehijas numuru (POST /v1/numbers vai portālā) un iestatiet tā maršrutēšanu - aģents, pāradresēšana vai SIP. SMS saņemšanai un sūtīšanai no sava numura nopērciet arī mobilo numuru (POST /v1/sms-numbers vai portālā sadaļā Numuri): Čehijas mobilo numuru tikai SMS, bez zvaniem. Ja vēlaties zvanus un SMS uz viena numura, divu numuru vietā pasūtiet numurs zvaniem un SMS (POST /v1/voice-sms-numbers vai portālā): Prāgas fiksēto numuru, ko pēc pasūtīšanas reģistrē pie operatora, parasti līdz 1 darbadienai. Zvanus uz to atbild tikai aģents uz volai paša balss dzinēja (to nevar novirzīt uz SIP vai pāradresēt), tāpēc tas neder aģentam, kas darbojas citur.

  2. Atslēga

    Portālā sadaļā AI asistents izveidojiet API atslēgu.

  3. Webhook

    Iestatiet webhook (PUT /v1/webhook) uz to pašu adresi, uz kuru šobrīd nāk Twilio StatusCallback, un pielāgojiet apstrādi jaunajai notikuma formai. Ja adresē ir lietotājvārds un parole, pieteikšanos pārvietojiet uz pielāgotu galveni (headers, piemēram, Authorization: Basic ...), adresi ar pieteikšanās datiem volai noraidīs.

  4. Tests

    Pirms pārslēdzat reālo datplūsmu, nosūtiet sev SMS un veiciet testa zvanu uz savu mobilo tālruni.

  5. DNS un vecie kontakti

    DNS parasti mainīt nav jāpiešķir - volai neizmanto jūsu domēnu. Taču pārbaudiet tīmekļa vietnes, e-pasta parakstus un dokumentāciju, kur vecais tālruņa numurs ir ierakstīts tieši.

Kad palikt pie Twilio

Migrācija nav piemērota ikvienam - papildus pārskatam iepriekš apsveriet arī šo:

  • Izejošie zvani no volai iet tikai uz Čehijas un Slovākijas numuriem (+420, +421) - uz ārzemju numuru nevarēsiet piezvanīt pat no nopirkta Čehijas numura.
  • Jums vajag lielāku apjomu par 60 pieprasījumiem minūtē - tas ir kopīgs REST API un MCP servera ierobežojums.

Sāciet migrāciju

Reģistrācija aizņem minūti, un pirmie 50 kr kredīta ir no mums - izmēģiniet jauno API, pirms pārslēdzat reālo datplūsmu.