Liigu sisu juurde

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.

Twiliovolai
Account SID + Auth TokenAPI võti vk_...
Messages resourcePOST /v1/messages
From (saatja number)fromNumber (mobiilinumbri lisand või number kõnede ja SMS-ide jaoks)
Calls resourcePOST /v1/calls
IncomingPhoneNumbersGET 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
StatusCallbacksündmuste veebikonks
TwiMLhäälagent (systemPrompt)
X-Twilio-SignatureVolai-Signature

Kood kõrvuti

SMS-i saatmine - sama mõte, teine 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 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.

text
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

  1. 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.

  2. Võti

    Looge API võti portaalis jaotises AI assistent.

  3. 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.

  4. Test

    Enne tegeliku liikluse ümberlülitamist saatke endale SMS ja tehke proovikõne oma mobiilile.

  5. 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.