Ceļveži

SIP

Ja jums nepietiek ar balss aģentu vai vienkāršu pāradresēšanu un vēlaties savu numuru pievienot savam softphone vai telefona centrālei (PBX), jums vajadzīgs SIP trunk pakalpojumu sniedzējs - volai tāds ir. Šī lapa ir soli pa solim sniegts ceļvedis.

1Ienākošie zvani uz jūsu SIP serveri

Iestatiet numura maršrutēšanu uz mode: "sip" un norādiet savu sipUri - no šejienes zvans nonāk tieši pie jums, nevis pie mūsu aģenta vai pāradresēšanas:

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"}}'

Tiek rēķināta tikai ienākošā minūte (0,50 kr/min (≈ 0,02 EUR)), bez papildu aģenta - pilnā pieprasījuma forma un citi maršrutēšanas režīmi ir REST API atsaucē.

Autentifikācija jūsu centrālē

Zvanu uz jūsu SIP serveri vispirms sūtām kā neautentificētu INVITE uz sipUri. Centrāle, kas uz to atbild ar pieteikšanās izaicinājumu (401/407) un bez papildu datiem zvanu noraida, šādā veidā zvanu nesaņems - izaicinājumam nav kam atbildēt. Tāpēc maršrutēšanai papildus norādiet sipUsername un sipPassword - ja norādīti abi, mūsu tīkls mērķī piesakās (SIP digest) un sazvana izsaucamo numuru. Pārbaudīts ar reālu zvanu uz Vapi vietējo SIP numuru, kas pieņem piekļuves datus neatkarīgi no to satura. Vai zvanu savienos arī jūsu centrāle, atkarīgs no tās - tai uz INVITE patiešām jāatbild ar izaicinājumu un jāatzīst jūsu norādītais lietotājvārds un parole; to negarantējam katrai centrālei (testā tas neizdevās, piemēram, pret Twilio SIP domēnu). Bez sipUsername un sipPassword maršrutēšana paliek pašreizējā neautentificētajā veidā. Piekļuves datus maršrutēšanai pievieno šādi:

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"}}'

Izsaucamo numuru vienmēr sūtām tieši tādā formā, kāda tā ir sipUri pirms @ zīmes - nekādu prefiksu vai nulli nepievienojam un nenoņemam, tāpēc mērķa centrālei jāprot apstrādāt tieši to, ko tur ierakstāt.

Ne sipUsername, ne sipPassword nedrīkst saturēt kolu, @ zīmi, atstarpi, pēdiņu vai atpakaļvērsto slīpsvītru, un katrs var būt ne garāks par 64 rakstzīmēm.

Aizpildīt tikai vienu no abiem laukiem nevar - API atgriež kļūdu „Lūdzu, aizpildiet gan lietotājvārdu, gan paroli vai abus atstājiet tukšus.”.

Kols sipUri lietotāja daļā (pirms @ zīmes) un ports hostā (aiz kola pie servera, piemēram, :5060) kopā ar aizpildītiem sipUsername un sipPassword pagaidām netiek atbalstīti - abos gadījumos tiek atgriezta tā pati stingrā kļūda. Bez piekļuves datiem abi darbojas nemainīti.

Izņēmums: Vapi BYO SIP trunk (adrese <credentialId>.sip.vapi.ai, ES reģiona organizācijai <credentialId>.sip.eu.vapi.ai) piekļuves datus neizmanto. Vapi mūsu zvanus atpazīst pēc IP trunk vārtejās, un, ja sipUsername un sipPassword ir aizpildīti, zvans netiktu savienots, tāpēc API šādu maršrutēšanu noraida ar kodu validation. Tas neattiecas uz Vapi vietējo SIP numuru (sip:<vārds>@sip.vapi.ai).

2Numura SIP piekļuves dati

Līnijas piekļuves datus iegūstat ar vienu izsaukumu:

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"]
}

Iestatīšana softphone (Zoiper, Linphone)

Abās lietotnēs ievadāt būtībā vienu un to pašu, tikai citos nosaukumos - meklējiet „Pievienot kontu” / „SIP konts”:

Pēc saglabāšanas softphone vajadzētu reģistrēties (statusa ikona „tiešsaistē”/„reģistrēts”), un zvani uz numuru sāks zvanīt tieši tajā.

3Izejošie zvani no SIP klienta

Tiklīdz softphone ir reģistrēts, tas pats var zvanīt uz āru caur šo līniju - šim nolūkam nav jāizsauc neviens mūsu API, zvanāt tieši no klienta kā no parastas tālruņa līnijas.

4Ierobežojumi

• Viena reģistrācija uz līniju - viens piekļuves datu komplekts atbalsta vienu reģistrētu ierīci vienlaikus. Ja pierakstāties ar otru klientu, pirmais, visticamāk, zaudēs reģistrāciju - nepaļaujieties uz vairākām ierīcēm vienlaikus vienā līnijā.
• Izejošie no sava aģenta jā, pilna trunk savienošana (peering) nē - līnijas piekļuves dati ir paredzēti tam, lai JŪSU klients reģistrētos pie MUMS kā tālrunis. Izejošie zvani no jūsu paša balss aģenta (ElevenLabs vai cita platforma) tomēr šobrīd IR iespējami - caur relay, sk. Savs aģents. Taču joprojām nevar pievienot jūsu centrāli kā līdzvērtīgu operatoru ar savu IENĀKOŠO zvanu maršrutēšanu no ārpuses - tam izmantojiet maršrutēšanu forward uz jūsu centrāles numuru.
• Tikai balss - bez video vai citiem SIP paplašinājumiem.