Vodiči

SIP

Ako vam nisu dovoljni glasovni agent ni jednostavno preusmjeravanje, a broj želite povezati u vlastiti softphone ili telefonsku centralu (PBX), trebate pružatelja SIP trunka - volai to jest. Ova stranica je vodič korak po korak.

1Dolazni pozivi na vaš SIP poslužitelj

Postavite usmjeravanje broja na mode: "sip" i unesite svoj sipUri - odavde poziv ide izravno vama, ne našoj ponudi agenta ni preusmjeravanja:

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

Naplaćuje se samo dolazna minuta (0,50 kr/min (≈ 0,02 EUR)), bez dodatnog agenta - cjelovit oblik zahtjeva i ostali načini usmjeravanja nalaze se u REST API referenci.

Prijava na vašoj centrali

Poziv na vaš SIP poslužitelj najprije šaljemo kao neprijavljeni INVITE na sipUri. Centrala koja na njega odgovori izazovom za prijavu (401/407) i bez dodatnih podataka odbije poziv, u ovom obliku ga neće primiti - izazov naime nema tko prihvatiti. Zato u usmjeravanje dodatno unesite sipUsername i sipPassword - unosom oba polja naša se mreža na odredištu prijavljuje (SIP digest) i bira traženi broj. Provjereno stvarnim pozivom na izvorni SIP broj Vapija, koji prihvaća prijavne podatke bez obzira na njihov sadržaj. Hoće li poziv spojiti i vaša centrala, ovisi o njoj - mora na INVITE doista odgovoriti izazovom i priznati uneseno korisničko ime i lozinku; to ne jamčimo za svaku centralu (u testu to nije uspjelo, primjerice, prema SIP domeni Twilija). Bez sipUsername i sipPassword usmjeravanje ostaje u današnjem neprijavljenom obliku. Prijavu dodajete u usmjeravanje ovako:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_VAS_KLJUC" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:recepcija@vas-server.hr", "sipUsername": "recepcija", "sipPassword": "tajnalozinka123"}}'

Pozvani broj uvijek šaljemo točno u obliku u kojem je u sipUri ispred znaka @ - ne dodajemo niti oduzimamo pozivni broj ni nulu, pa se ciljna centrala mora znati nositi upravo s onim što tamo upišete.

sipUsername i sipPassword ne smiju sadržavati dvotočku, znak @, razmak, navodnik ni obrnutu kosu crtu i smiju imati najviše 64 znaka svako.

Unos samo jednog od polja nije moguć - API vraća pogrešku „Vyplň prosím jméno i heslo, nebo obojí nech prázdné.“.

Dvotočka u korisničkom dijelu sipUri (ispred znaka @) ni port u hostu (iza dvotočke kod poslužitelja, npr. :5060) za sada se ne podržavaju uz uneseni sipUsername i sipPassword - oboje vraća istu tvrdu pogrešku. Bez prijavnih podataka oboje radi bez promjene.

Iznimka: BYO SIP trunk Vapija (adresa <credentialId>.sip.vapi.ai, kod organizacije u EU regiji <credentialId>.sip.eu.vapi.ai) ne koristi prijavne podatke. Vapi naše pozive prepoznaje po IP adresi u gatewayima trunka i s unesenim sipUsername i sipPassword poziv se ne bi spojio, pa API takvo usmjeravanje odbija s kodom validation. To se ne odnosi na izvorni SIP broj Vapija (sip:<ime>@sip.vapi.ai).

2SIP podaci broja

Prijavne podatke linije preuzimate jednim pozivom:

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

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

Postavke u softphoneu (Zoiper, Linphone)

U obje aplikacije unosite u biti isto, samo drukčije nazvano - potražite „Dodaj račun“ / „SIP račun“:

Nakon spremanja softphone bi se trebao registrirati (statusna ikona „online“/„registriran“) i pozivi na broj počet će zvoniti izravno u njemu.

3Odlazno pozivanje preko SIP klijenta

Čim je softphone registriran, može preko ove linije sam birati prema van - zbog toga ne morate zvati nijedan naš API, biranje ide izravno iz klijenta kao s obične telefonske linije.

4Ograničenja

• Jedna registracija po liniji - jedni prijavni podaci podnose jedan registrirani uređaj istodobno. Ako se prijavite drugim klijentom, prvi će registraciju vjerojatno izgubiti - ne oslanjajte se na više uređaja istodobno na jednoj liniji.
• Odlazno iz vlastitog agenta da, puni trunk peering ne - prijavni podaci linije služe tome da se VAŠ klijent registrira kod NAS kao telefon. Odlazni pozivi iz vlastitog glasovnog agenta (ElevenLabs ili neka druga platforma) danas ipak IDU - preko releja, vidi Vlastiti agent. I dalje se međutim ne može povezati vaša centrala kao ravnopravan operator s vlastitim usmjeravanjem DOLAZNIH poziva izvana - za to upotrijebite usmjeravanje forward na broj vaše centrale.
• Samo glas - bez videa i drugih SIP proširenja.