CTI

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

Dokumentace
Getting Started with the API PBX
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