Siirtymä
Siirry Twiliosta volaihin yhdessä iltapäivässä.
Pienempi API, samat käsitteet. Twilion käsitteet vastaavuuksineen volaissa, koodi rinnakkain, valmis kehote tekoälyagentille ja tarkistuslista kaikesta siirrettävästä.
Onko tämä oikea tie?
Kyllä, jos tarvitaan
- Tšekkiläisiä puhelinnumeroita (+420) ja paikallisia puhelutaksoja.
- Puheagentti, joka toimii suoraan käyttöön otettuna eikä ole rakennettu äänivirroista ja omasta mallista.
- Saldo ladataan oman maan valuutassa ilman valuuttayllätyksiä korttitiliotteella.
- Puhelut ja tekstiviestit samassa tšekkiläisessä numerossa - tšekkiläinen Twilio-numero hoitaa joko puhelut tai tekstiviestit, kun taas volai tarjoaa tuotteen numero puheluille ja tekstiviesteille (lankanumero Prahassa).
Twiliossa kannattaa pysyä, jos tarvitaan
- Enemmän numeroita tekstiviestien vastaanottoon kuin tilin rajat sallivat tai tekstiviestien vastaanottoa muissa maissa - volain puhenumerot eivät vastaanota tekstiviestejä, mutta matkapuhelinnumero (tšekkiläinen numero pelkästään tekstiviesteille) ja numero puheluille ja tekstiviesteille (lankanumero Prahassa) voivat, enintään kaksi kumpaakin tyyppiä tiliä kohden; palveluiden vahvistuskoodeja ei taata.
- Puhelinnumeroita volain tarjonnan ulkopuolelta: tšekkiläisiä, slovakialaisia vain Bratislavan suuntanumerolla sekä nykyisen tarjonnan maiden numeroita, jotka ovat vain puheluille, ilman tekstiviestejä ja lähteviin puheluihin vain numeron maahan ja Tšekkiin.
- WhatsApp, video tai muut viestintäkanavat.
Mikä vastaa mitäkin
Twilio SDK ei muutu volaille sopivaksi pelkällä osoitteen vaihdolla - kyseessä on pienempi ja erilainen API. Käsitteet voi silti kartoittaa yksi yhteen.
| Twilio | volai |
|---|---|
| Account SID + Auth Token | API-avain vk_... |
| Messages resource | POST /v1/messages |
| From (lähettäjän numero) | fromNumber (lisäpalvelu matkapuhelinnumero tai numero puheluille ja tekstiviesteille) |
| Calls resource | POST /v1/calls |
| IncomingPhoneNumbers | GET ja POST /v1/numbers (matkapuhelinnumero: GET ja POST /v1/sms-numbers; numero puheluille ja tekstiviesteille: GET ja POST /v1/voice-sms-numbers) |
| Saapuvan viestin webhook (SmsUrl) | tapahtuma message.received |
| StatusCallback | webhook-tapahtumat |
| TwiML | puheagentti (systemPrompt) |
| X-Twilio-Signature | Volai-Signature |
Koodi rinnakkain
Tekstiviestin lähettäminen - sama ajatus, eri API.
Twilio (Node.js SDK)
const twilio = require("twilio");
const client = twilio(accountSid, authToken);
await client.messages.create({
body: "Moi Twiliolta!",
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: "Terveisiä volaista!",
}),
});Twilio määrittää lähettäjän kentällä from. volai ohittaa kentän from ja valitsee lähettäjän kentällä fromNumber (numero kutsusta GET /v1/sms-numbers, lisäpalvelu matkapuhelinnumero, tai kutsusta GET /v1/voice-sms-numbers, numero puheluille ja tekstiviesteille). Ilman fromNumber-kenttää tekstiviestit lähtevät jaetulla lähettäjänimellä SMSinfo, jolle vastaanottaja ei voi vastata.
Anna tämä tekoälyagentille
Kopioi kehote Claude Codeen, Cursoriin tai muuhun tekoälyeditoriin ja anna sen hoitaa siirtymä - SKILL.md antaa sille koko viitteen.
Lue SKILL.md volain verkkosivustolta (API:n perusosoite on siinä). Etsi projektistani Twilio SDK:n kutsut tekstiviesteille ja puheluille (client.messages.create, client.calls.create) ja kirjoita ne uudelleen volain REST-rajapintaan: POST /v1/messages tekstiviesteille, POST /v1/calls puheluille, otsake Authorization: Bearer vk_SINUN_AVAIMESI. Päivitä myös webhookien käsittely tiedoston SKILL.md mukaiseen muotoon, mukaan lukien otsakkeen Volai-Signature tarkistus.Tarkistuslista siirtymää varten
Numero
Osta tšekkiläinen numero (POST /v1/numbers tai portaalissa) ja määritä sen reititys - agentti, soitonsiirto tai SIP. Tekstiviestien vastaanottoa ja lähettämistä omasta numerosta varten ostetaan lisäksi matkapuhelinnumero (POST /v1/sms-numbers tai portaalissa kohdassa Puhelinnumerot): tšekkiläinen numero pelkästään tekstiviesteille, ilman puheluita. Jos puhelut ja tekstiviestit halutaan samaan numeroon, tilataan numero puheluille ja tekstiviesteille kahden numeron sijaan (POST /v1/voice-sms-numbers tai portaalissa): lankanumero Prahassa, joka rekisteröidään operaattorille tilauksen jälkeen, yleensä 1 arkipäivän kuluessa. Puheluihin vastaa vain volain oman puhemoottorin agentti (numeroa ei voi reitittää SIP:iin eikä siirtää soitonsiirrolla), joten se ei sovi agentille, joka toimii muualla.
Avain
Luo API-avain portaalissa kohdassa Tekoälyavustaja.
Webhook
Määritä webhook (PUT /v1/webhook) samaan osoitteeseen, johon Twilion StatusCallback ohjautuu nykyisin, ja mukauta käsittely uuteen tapahtumamuotoon. Jos osoite sisältää käyttäjänimen ja salasanan, kirjautuminen on siirrettävä omaan otsakkeeseen (headers, esimerkiksi Authorization: Basic ...), koska volai hylkää osoitteen, jossa on kirjautumistiedot.
Testi
Ennen varsinaisen liikenteen siirtämistä: lähetä itselle tekstiviesti ja soita testipuhelu omaan matkapuhelimeen.
DNS ja vanhat yhteystiedot
DNS:ää ei yleensä tarvitse muuttaa - volai ei käytä omaa verkkotunnusta. Tarkista sen sijaan verkkosivustot, sähköpostin allekirjoitukset ja dokumentaatio, joihin vanha puhelinnumero on kirjoitettu käsin.
Milloin on parasta pysyä Twiliossa
Siirtymä ei sovi kaikille - yllä olevan yleiskatsauksen lisäksi myös nämä kannattaa punnita:
- Tšekkiläisestä numerosta voi soittaa tšekkiläisiin ja slovakialaisiin numeroihin (+420, +421), ei muualle. numero toisessa maassa soittaa Tšekkiin ja maasta riippuen myös omaan maahansa.
- Tarve on suurempi kuin 60 kutsua minuutissa - se on yhteinen raja sekä REST-rajapinnalle että MCP-palvelimelle.
Aloita siirtymä
Rekisteröityminen vie minuutin, ja ensimmäiset 2 € saldoa lahjoitamme - uutta API:a voi kokeilla ennen varsinaisen liikenteen siirtämistä.