Hlasové služby IPEX

Systém IPEX je komunikační řešení s telefonní ústřednou iPBX (virtuální, fyzickou), IP telefony a volání (IP telefonii).

Mango umožňuje stahování CDR záznamů o uskutečněných hovorech pomocí WSDL rozhraní ústředny IPEX a následně jejich billing formou hlasových služeb.

1. Obecný popis

Pokud Vy nebo Vaši zákazníci využívají hlasové služby IPEX, máte možnost tyto služby účtovat v Mangu. Mango přistupuje od systému IPEX pomocí rozhraní API 8 (REST). Co je k tomu potřeba? Na to by Vám měl odpovědět tento článek.

Nejprve je potřeba nastavit rozhraní pro komunikaci. To lze provést vložením a nastavením parametrů zařízení třídy VoIP Proxy. Dále musí mít Mango informace o jednotlivých telefonních číslech. Telefonní čísla musí být nastavena jako parametry služeb zákazníka (třída Hlasová služba IPEX). Dále musí být správně nadefinované služby z pohledu výpočtu DPH. Vzhledem k tomu, že rozhraní předává ceny bez DPH, je nutné mít pro billing hlasových služeb IPEX mít nadefinované služby s výpočet zdola.

Moduly, které využijete k této funkcionalitě:
  • mod_submenu_services PRODUKTY/SLUŽBY
    - definice služeb, které pak aktivujete zákazníkům
  • mod_submenu_user_list KARTA ZÁKAZNÍKA
    - aktivace hlasových služeb a jejich parametrů
  • mod_submenu_wizard_uds WIZARD
    - aktivace hlasových služeb a jejich parametrů
  • mod_submenu_network SÍŤ
    - vložení a správa zařízení třídy VoIP Proxy

2. Zařízení VoIP Proxy - konfigurace rozhraní

Rozhraní IPEX je v Mangu reprezentováno zařízením třídy VoIP Proxy. Zařízení této třídy vložíte a následně nastavujete v modulu
mod_submenu_network SÍŤ
. Vyhledání můžete provést nastavením filtru Třída zařízení na hodnotu VoIP Proxy. Aby docházelo ke stahování dat, je nutné, aby zařízení mělo nastavené příznak AP. Tato třída zařízení umožňuje nastavit parametry pro přístup na WSDL rozhraní ústředny a další parametry, které určují chování rozhraní.

Sada parametrůSorted ascending Parametr Hodnota Význam
  Infrastruktura LOCID Lokace, ve které je zařízení zobrazováno v modulu Infrastruktura
  Překlad do Phonet STRING nevyužito
  Překlad do Manga STRING nevyužito
  Koeficient ceny STRING nevyužito
  Typ Ipex NUM Příznak, že se jedná o zařízení s konfigurací rozhraní IPEX
IPEX - download CDR Perioda NUM Periodicita stahování dat v minutách
IPEX - download CDR Importovat ceny BOOL Je-li nastaveno, cena se importuje v IPEXu, jinak se počítá v Mangu
IPEX - download CDR Importovat od data DATE Jestliže dosud nebyla žádná CDR stažena, stáhnout zpětně od tohoto data
IPEX - download CDR Čas posledního importu STRING Čas provedení posledního importu (s indexem 0 standardní, s indexem 1 denní rozšířený, s indexem 2 rekoncilační)
IPEX - nastavení web service URL SOAP API STRING URL webové služby pro řízení ústředny
IPEX - nastavení web service Uživatel STRING Jméno uživatelského účtu pro přihlášení k webové službě
IPEX - nastavení web service Heslo STRING Heslo k uživatelskému účtu pro přihlášení k webové službě

Čas posledního importu slouží jako informace o tom, kdy byl naposledy proveden import CDR záznamů. Dle hodnoty parametru Perioda se provádí standardní import nových CDR záznamů. Kromě tohoto se navíc 1x denně provádí rozšířený import, který si za 24 hodin zpětně načte všechna CDR znovu a kontroluje, zda nějaké zpětně nepřibylo. Podobný postup se provádí i 1x měsíčně. Někdy, především u roamingových volání může dojít k tomu, že CDR záznam vzniká dodatečně s několika denním zpožděním.

4. Telefonní čísla

Jedním z parametrů hlasové služby zákazníka, který musíte při její aktivaci zadávat je telefonní číslo. Tato telefonní čísla umí Mango předvyplňovat ze seznamu volných telefonních čísel, který můžete nadefinovat v modulu
mod_submenu_phone_numbers TELEFONNÍ ČÍSLA
. Zda se hodnota předvyplňuje nebo ne je součástí interní konfigurace tohoto parametru.

5. Přiřazování CDR záznamů službě zákazníka

Při stahování jednotlivých záznamů je dohledáváno telefonní číslo v parametru služeb, které obsahují hlasovou složku u všech zákazníků lokace. Pokud je taková služba nalezena, CDR záznam je zákazníkovi a jeho službě přiřazen. V závislosti na hodnotě parametru Importovat ceny zařízení třídy VoIP Proxy se může k zaznamenanému hovoru uložit i jeho cena, která je součástí CDR záznamu.

Uskutečněné hovory Mango zobrazuje v modulu
mod_submenu_voice_overview VOLÁNÍ VOIP
jako přehled pro celou lokaci a v modulu
mod_submenu_user_list KARTA ZÁKAZNÍKA
jako přehled za konkrétního zákazníka.

6. Účtování hlasových služeb

Pro hlasové služby lze využít všechny způsoby účtování, kromě předplatného uniCredit. Rozhraní IPEX nenabízí možnost pracovat s kreditem zákazníka. Neumí čerpat z uniCreditu, provádět jeho rezervaci a v závislosti na stavu kreditu v Mangu případně neumožnit volání zákazníkovi.

arrowbright Více info: Účtování produktů a služeb

6.1. Uzávěrky hlasových služeb

Na konci periody služby musíte provádět uzávěrky hlasových služeb zákazníka. Mango umožňuje nastavit automatické provádění těchto uzávěrek.

Rozhraní IPEX nepředává záznamy o hovorech sekvenčně. Může se stát, že některý záznam předá později. Může se stát, že tento později stažený záznam spadá do uzavřeného období. Při následující uzávěrce je operátor na tento chybný stav upozorněn. Datum uzávěrky, do které spadá vybraný záznam lze zobrazit v modulu
mod_submenu_voice_overview VOLÁNÍ VOIP
,
mod_submenu_sms SMS
,
mod_submenu_video_on_demand VIDEO ON DEMAND
a
mod_submenu_gsm_overview GSM
.

arrowbright Více info: Referenční popis modulu Volání VoIP

arrowbleft Zpět na:
Topic revision: r8 - 10 Oct 2022, JiriNecek
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback