Siirry sisältöön

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.

Twiliovolai
Account SID + Auth TokenAPI-avain vk_...
Messages resourcePOST /v1/messages
From (lähettäjän numero)fromNumber (lisäpalvelu matkapuhelinnumero tai numero puheluille ja tekstiviesteille)
Calls resourcePOST /v1/calls
IncomingPhoneNumbersGET 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
StatusCallbackwebhook-tapahtumat
TwiMLpuheagentti (systemPrompt)
X-Twilio-SignatureVolai-Signature

Koodi rinnakkain

Tekstiviestin lähettäminen - sama ajatus, eri API.

Twilio (Node.js SDK)

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

await client.messages.create({
  body: "Moi Twiliolta!",
  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: "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.

text
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

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

  2. Avain

    Luo API-avain portaalissa kohdassa Tekoälyavustaja.

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

  4. Testi

    Ennen varsinaisen liikenteen siirtämistä: lähetä itselle tekstiviesti ja soita testipuhelu omaan matkapuhelimeen.

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