Webová integrace slouží k propojení webových IS/CRM s telefonní ústřednou iPBX. Propojení slouží pro informace o hovorech a jednoduché možnosti ovládání hovorů(vytvoření, zavěšení, přepojení). Pomocí této funkce dokážete přímo vyhledat informace o volajícím ve svém systému a zobrazit tato data uživateli. Propojení je založeno na GraphQL subskripcích, které využívá technologie WebSockets.
Nastavení integrace v PBX
Do nastavení CTI se dostanete přes rozhraní ústředny v sekci API a poté se přepnete do podsekce CTI.
Aktivace modulu
Aktivaci lze provést po zaškrtnutí přepínače "Události o hovorech" aktivovat události o hovorech. Změny je nutno potvrdit uložením a aplikováním změn (reload ústředny).
Dále je potřeba vyplnit další údaje pro CTI.
Přepis zdrojového čísla - úprava formátu zdrojového čísla
Přepis cílového čísla - úprava formátu cílové čísla
Expirace dohledané identity -
Expirace neznámé identity -
Možnosti ovládání hovorů
REST API: https://ipbxapi.voipex.io
Události jsou navázané na linku uživatele, proto je nutné pro autentizaci použít token uživatele. V případě použití systémového účtu je nutné využit impersonifikaci a získat token konkrétního uživatele.
Akce:
vytvoření hovoru: POST /calls
zavěšení hovoru: DELETE /calls
přepojení hovoru: PUT /calls/transfer
zrušení přepojení s konzultací DELETE /calls/transfer
Odběr událostí
Události: newcall, ringing, answered, hangup, attendedtransfer, cancelattendedtransfer
Sandbox: https://ipbxapi.voipex.io/graphql
Př. GraphQL subskripce:
subscription Subscription { ctiEvents { event callId direction from to userId cause reason queue customField customData } }
Př. Postman