Průvodci
SIP
Když ti nestačí hlasový agent ani jednoduché přesměrování a chceš si číslo připojit do vlastního softphonu nebo telefonní ústředny (PBX) - tahle stránka je návod krok za krokem.
1Příchozí hovory na tvůj SIP server
Nastav směrování čísla na mode: "sip" a zadej svoji sipUri - odsud dál hovor putuje přímo k tobě, ne k naší nabídce agenta ani přesměrování:
curl -X PATCH "https://volai.cz/v1/numbers/+420601234567" \
-H "Authorization: Bearer vk_TVUJ_KLIC" \
-H "Content-Type: application/json" \
-d '{"routing": {"mode": "sip", "sipUri": "sip:recepce@tvuj-server.cz"}}'Účtuje se jen příchozí minuta (0,50 Kč/min), žádný agent navíc - kompletní tvar požadavku i ostatní režimy směrování jsou v REST API referenci.
2SIP údaje čísla
Přihlašovací údaje linky si vyzvedneš jedním voláním:
curl "https://volai.cz/v1/numbers/+420601234567/sip" \
-H "Authorization: Bearer vk_TVUJ_KLIC"{
"server": "sip.odorik.cz",
"username": "123456",
"password": "a1b2c3d4e5f6"
}Nastavení v softphonu (Zoiper, Linphone)
V obou appkách zadáváš v zásadě totéž, jen jinak pojmenované - hledej „Přidat účet“ / „SIP účet“:
| Pole | Hodnota |
|---|---|
| Server / Doména | sip.odorik.cz |
| Uživatelské jméno | z odpovědi výše (username) |
| Heslo | z odpovědi výše (password) |
| Transport | UDP |
| Port | 5060 (výchozí SIP - pokud pole nabízí prázdnou volbu, nech ji prázdnou) |
Po uložení by se měl softphone zaregistrovat (stavová ikona „online“/„zaregistrováno“) a hovory na číslo začnou zvonit přímo v něm.
3Odchozí volání přes SIP klienta
Jakmile je softphone zaregistrovaný, může přes tuhle linku sám vytáčet ven - nemusíš kvůli tomu volat žádné naše API, vytáčíš přímo z klienta jako z obyčejné telefonní linky.
Minuty jdou z\u00A0kreditu volai
Odchozí volání přes SIP klienta se účtuje stejnou sazbou jako odchozí hovor přes /min) a strhává se z tvého kreditu - ne z nějakého odděleného SIP účtu.
Spojení jde přímo mezi tvým klientem a Odorikem, ne přes naše API, takže minuty nejde zablokovat přesně v okamžiku vytáčení - doúčtují se z pravidelné synchronizace (do pár minut). Když kredit klesne na nulu nebo do mínusu, nové akce přes API/MCP se začnou odmítat a číslo se po 7 dnech v mínusu zaparkuje (SIP přístup tím zanikne). Kredit si proto hlídej v předstihu, ne až na nule.
4Omezení
- Jedna registrace na linku - jedny přihlašovací údaje unesou jedno zaregistrované zařízení najednou. Když se přihlásíš druhým klientem, první o registraci nejspíš přijde - nespoléhej na víc zařízení současně na jedné lince.
- Žádné vlastní trunky do volai - přihlašovací údaje linky slouží k tomu, aby se TVŮJ klient zaregistroval k NÁM, ne k propojení tvojí vlastní telefonní ústředny jako rovnocenného operátora. Pro příjem hovorů z jiných zdrojů použij směrování
forwardna číslo tvojí ústředny. - Jen hlas - žádné video ani jiné SIP rozšíření.