Ghiduri

SIP

Dacă agentul vocal și redirecționarea simplă nu vă ajung și doriți să conectați un număr la propriul softphone sau la centrala telefonică (PBX), aveți nevoie de un furnizor de SIP trunk - volai este unul. Această pagină este un ghid pas cu pas.

1Apeluri primite către serverul dumneavoastră SIP

Setați rutarea numărului pe mode: "sip" și introduceți sipUri dumneavoastră - de aici apelul ajunge direct la dumneavoastră, nu la oferta noastră de agent sau de redirecționare:

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

Se taxează doar minutul primit (0,50 kr/min (≈ 0,10 RON)), fără agent suplimentar - forma completă a cererii și celelalte moduri de rutare sunt în referința API REST.

Autentificarea pe centrala dumneavoastră

Apelul către serverul dumneavoastră SIP îl trimitem mai întâi ca INVITE neautentificat către sipUri. O centrală care răspunde la el cu o cerere de autentificare (401/407) și fără alte date respinge apelul, nu îl va primi în această formă - cererea nu are cine să o preia. Completați de aceea în rutare, suplimentar, sipUsername și sipPassword - completându-le pe ambele, rețeaua noastră se autentifică pe țintă (SIP digest) și formează numărul apelat. Verificat cu un apel real către un număr SIP nativ Vapi, care acceptă datele de autentificare indiferent de conținutul lor. Dacă apelul îl conectează și centrala dumneavoastră depinde de ea - trebuie să răspundă efectiv la INVITE cu o cerere de autentificare și să accepte numele și parola introduse; nu garantăm acest lucru pentru fiecare centrală (în test nu a reușit, de exemplu, împotriva unui domeniu SIP Twilio). Fără sipUsername și sipPassword rutarea rămâne în forma actuală, neautentificată. Autentificarea o adăugați în rutare astfel:

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

Numărul apelat îl trimitem întotdeauna exact în forma în care apare în sipUri înainte de semnul @ - nu adăugăm și nu eliminăm niciun prefix sau zero, deci centrala țintă trebuie să se descurce exact cu ceea ce scrieți acolo.

sipUsername și sipPassword nu au voie să conțină două puncte, semnul @, spațiu, ghilimele sau backslash și pot avea cel mult 64 de caractere fiecare.

Completarea doar a unuia dintre cele două câmpuri este respinsă - API-ul returnează "Please fill in both username and password, or leave both empty."

Două puncte în partea de utilizator a sipUri (înainte de @) și portul din host (după două puncte la server, de exemplu :5060) nu sunt deocamdată acceptate împreună cu sipUsername și sipPassword completate - ambele returnează aceeași eroare fermă. Fără date de autentificare ambele funcționează neschimbat.

Excepție: SIP trunk-ul BYO Vapi (adresa <credentialId>.sip.vapi.ai, pentru o organizație din regiunea UE <credentialId>.sip.eu.vapi.ai) nu folosește date de autentificare. Vapi recunoaște apelurile noastre după IP-urile din gateways ale trunk-ului, iar cu sipUsername și sipPassword completate apelul nu s-ar conecta, de aceea API-ul respinge o astfel de rutare cu codul validation. Numărul SIP nativ Vapi (sip:<nume>@sip.vapi.ai) nu este afectat.

2Datele SIP ale numărului

Datele de autentificare ale liniei le obțineți cu un singur apel:

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

Configurare în softphone (Zoiper, Linphone)

În ambele aplicații introduceți în esență același lucru, doar denumit diferit - căutați „Adăugare cont” / „Cont SIP”:

După salvare, softphone-ul ar trebui să se înregistreze (pictograma de stare „online” / „înregistrat”), iar apelurile către număr încep să sune direct în el.

3Apeluri efectuate printr-un client SIP

De îndată ce softphone-ul este înregistrat, poate iniția singur apeluri prin această linie - nu trebuie să apelați API-ul nostru pentru asta, formați direct din client ca de pe o linie telefonică obișnuită.

4Limitări

• O singură înregistrare pe linie - un singur set de date de autentificare susține un singur dispozitiv înregistrat la un moment dat. Dacă vă conectați cu un al doilea client, primul își pierde probabil înregistrarea - nu vă bazați pe mai multe dispozitive simultan pe aceeași linie.
• Apeluri efectuate de la un agent propriu da, peering complet de trunk nu - datele de autentificare ale liniei servesc ca CLIENTUL dumneavoastră să se înregistreze la NOI ca telefon. Apelurile efectuate de la propriul agent vocal (ElevenLabs sau altă platformă) MERG însă astăzi - printr-un relay, vedeți Agent propriu. Tot nu se poate însă conecta centrala dumneavoastră ca operator egal, cu rutare proprie a apelurilor PRIMITE din exterior - pentru asta folosiți rutarea forward către numărul centralei dumneavoastră.
• Doar voce - fără video sau alte extensii SIP.