Juhendid

SIP

Kui häälagendist ega lihtsast ümbersuunamisest ei piisa ja soovite numbri ühendada oma pehmetelefoni või telefonijaamaga (PBX), vajate SIP-trunki pakkujat - volai on selline. See leht on samm-sammuline juhend.

1Sissetulevad kõned teie SIP-serverisse

Seadke numbri suunamine väärtusele mode: "sip" ja sisestage oma sipUri - sealt läheb kõne otse teie juurde, mitte meie agendi ega ümbersuunamise juurde:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@your-server.com"}}'

Arvestatakse ainult sissetulevat minutit (0,50 kr/min (≈ 0,02 EUR)), lisaagenti ei ole - päringu täielik vorm ja teised suunamisrežiimid on REST API viites.

Autentimine teie telefonijaamas

Kõne teie SIP-serverisse saadame kõigepealt autentimata INVITE-ina aadressile sipUri. Telefonijaam, mis vastab sellele sisselogimisnõudega (401/407) ja lükkab kõne ilma lisaandmeteta tagasi, ei saa seda selles vormis kätte - nõudele ei ole kellelgi vastata. Täitke seetõttu suunamises lisaks sipUsername ja sipPassword - mõlema täitmisel logib meie võrk sihtkohas sisse (SIP digest) ja valib kutsutava numbri. Kontrollitud päris kõnega Vapi natiivsele SIP-numbrile, mis võtab sisselogimisandmed vastu sõltumata nende sisust. Kas teie telefonijaam kõne ühendab, sõltub temast - ta peab INVITE'ile tõepoolest nõudega vastama ning sisestatud kasutajanime ja parooli tunnustama; me ei garanteeri seda iga telefonijaama puhul (testis see ei õnnestunud näiteks Twilio SIP-domeeni vastu). Ilma sipUsername'i ja sipPassword'ita jääb suunamine praegusesse autentimata vormi. Sisselogimise lisate suunamisse nii:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@your-server.com", "sipUsername": "reception", "sipPassword": "supersecret123"}}'

Kutsutava numbri saadame alati täpselt sellisel kujul, nagu see on sipUri-s enne ätimärki - ei lisa ega eemalda ühtegi suunakoodi ega nulli, seega peab sihttelefonijaam saama hakkama täpselt sellega, mille te sinna kirjutate.

Ei sipUsername ega sipPassword tohi sisaldada koolonit, ätimärki, tühikut, jutumärki ega kaldkriipsu tagurpidi ning kumbki võib olla kuni 64 märki pikk.

Ainult ühe välja täitmine ei ole võimalik - API tagastab vea "Please fill in both username and password, or leave both empty."

Koolon sipUri kasutajaosas (enne ätimärki) ja port hostis (serveri järel koolonist, nt :5060) ei ole täidetud sipUsername'i ja sipPassword'iga veel toetatud - mõlemad annavad sama range vea. Ilma sisselogimisandmeteta töötavad mõlemad muutmata kujul.

Erand: Vapi BYO SIP-trunk (aadress <credentialId>.sip.vapi.ai, ELi regiooni organisatsiooni puhul <credentialId>.sip.eu.vapi.ai) sisselogimisandmeid ei kasuta. Vapi tunneb meie kõned ära trunki lüüside IP järgi ja täidetud sipUsername'i ja sipPassword'iga kõnet ei ühendataks, seetõttu lükkab API sellise suunamise tagasi koodiga validation. Vapi natiivset SIP-numbrit (sip:<nimi>@sip.vapi.ai) see ei puuduta.

2Numbri SIP-andmed

Liini sisselogimisandmed saate ühe kutsega:

curl "https://volai.eu/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Seadistus pehmetelefonis (Zoiper, Linphone)

Mõlemas rakenduses sisestate põhimõtteliselt sama, ainult teisiti nimetatult - otsige „Lisa konto“ / „SIP-konto“:

Pärast salvestamist peaks pehmetelefon registreeruma (olekuikoon „online“/„registreeritud“) ja numbrile tulevad kõned hakkavad helisema otse selles.

3Väljaminevad kõned SIP-kliendi kaudu

Kui pehmetelefon on registreeritud, saab ta selle liini kaudu ise välja helistada - selleks ei pea te kutsuma ühtegi meie API-t, valite numbri otse kliendis nagu tavalisel telefoniliinil.

4Piirangud

• Üks registreering liini kohta - üks sisselogimisandmete komplekt kannab korraga ühte registreeritud seadet. Kui logite sisse teise kliendiga, kaotab esimene registreeringu tõenäoliselt - ärge lootke mitmele seadmele korraga ühel liinil.
• Väljaminev oma agendilt jah, täielik trunk-peering ei - liini sisselogimisandmed on selleks, et TEIE klient registreeruks meie juures telefonina. Väljaminevad kõned oma häälagendilt (ElevenLabs või muu platvorm) aga PRAEGU TOIMIVAD - releeteenuse kaudu, vt Oma agent. Siiski ei saa ühendada teie telefonijaama võrdväärse operaatorina oma SISSETULEVATE kõnede suunamisega väljastpoolt - selleks kasutage suunamist forward oma telefonijaama numbrile.
• Ainult heli - ei videot ega muid SIP-laiendusi.