/
Contacts

Contacts

led 28, 2021

 

Základní popis

Lze použít libovolnou z níže nabízených metod.

Pro autorizaci použijte login a heslo uživatele platformy VOIPEX (naimportované kontakty jsou dostupné pro všechny uživatele ve společné organizaci)

 

Sekce dat každého importovaného kontaktu

Popis

Povinné údaje v dané sekci

pojmenování kontaktu

tyto údaje lze následně zobrazovat v CTI okně při příchozím hovoru a v panelech a statistikách callcentra

je povinné uvedení alespoň jednoho z parametrů "lastName" nebo "firstName" nebo "organization"

telefonní a email kontaktní údaje

podle těchto údajů je vyhledáváno. Platnost telefonních čísel je kontrolována pomocí knihovny Googlei18n/libphonenumber (můžete si vaše čísla ověřit i pomocí API funkce /v3/contacts/validator/phone-number/{phoneNumber} ) 

je povinné alespoň jedno telefonní číslo. Minimálně musí být vždy vyplněno phone1

agenti pro obsluhu kontaktu

pomocí zde uložených značek lze dynamicky routovat hovory v IVR, více info v popisu nových funkcí iPBX 3.1.8 

nejsou povinné žádné údaje

doplňující uživatelská pole

tyto údaje lze následně zobrazovat v CTI okně při příchozím hovoru

nejsou povinné žádné údaje

 

 

Import dat pomocí CURL

Tato metoda je preferována pro dávkový import. Nahrazuje dřívější metody importu pomocí FTP

Pokud nemáte na své stanici nebo serveru CURL klienta, můžete si jej stáhnout pro svůj OS z https://curl.haxx.se/download.html

Importem jsou předchozí data smazána a nahrazena novými

Import se při nalezení chyby nezastaví, naimportují se všechny řádky kde nebyla nalezena chyba a všechny chybné řádky jsou vypsány na standardní výstup


Ukázka formátu příkazového řádku

curl -X POST -H "Content-Type: multipart/form-data" -H "Authorization: Basic <auth>" --form file=@<filename> https://flow.voipex.io/v3/contacts/upload

V příkazovém řádku upravte :

  • <auth> - zadejte "login:heslo" uživatele platformy VOIPEX (celý tento řetězec je nutno zakódovat jako Base64, např. pro údaje novak:hesloNovak použijete bm92YWs6aGVzbG9Ob3Zhaw==  )

  • <filename> - název vašeho CSV souboru, např. import.csv (soubor může být do velikosti max 20MB)

 

Pro konverzi řetězce na Base64 string můžete použít developerskou konzoli vašeho browseru (doporučen Chrome, ale není podmínkou) :

  • Ve vašem browseru stisknětě CTRL-Shift-i nebo F12

  • Přepněte se na záložku Console

  • Na příkazové řádce napište btoa("novak:hesloNovak") 

  • V výpisu dostanete potřebný Base64 hash

Struktura CSV souboru

  • Telefoní čísla: musí být v mezinárodním formátu (řádek v csv obsahující nevalidní telefonní číslo podle /v3/contacts/validator/phone-number/{phoneNumber} nebude zpracován)

  • Kódování: utf-8 (diakritika je akceptována)

  • Omezení: Každý záznam musí obsahovat minimálně jedno telefoní číslo. CSV soubor musí obsahovat řádek s hlavičkou.

  • Rozšiřující Uri sloupce : Pokud jsou uvedeny, stanou se v CTI okně zobrazené údaje klikatelnými a je otevřeno okno na uvedený link. POZOR !!! Při použití rozšiřujících Uri sloupců důrazně doporučujeme uživatelům povolit Editor kontaktů jen s oprávněním "Pouze čtení". Při editaci kontaktu uživatelem dojde ke smazání nastavení Uri sloupců.

  • Sloupce :

    • firstName - jméno max 255 znaků (povinné pokud není uvedeno lastName nebo organzation)

    • lastName - příjmení  max 255 znaků (povinné pokud není uvedeno firstName nebo organization)

    • organization - název organizace max 255 znaků (povinné pokud není uvedeno firstName nebo lastName)

    • externalId - id záznamu v externím systému  max 255 znaků

    • email - platná emailová adresa 

    • phone1 - primární telefonní číslo ve formátu +420xxxxxxxxx (povinné vždy)

    • phone2 -  sekundární telefonní číslo 

    • agent1 - max 55 znaků

    • agent2 - max 55 znaků

    • customField1 -  max 55 znaků 

    • customField2 -  max 55 znaků 

    • customField3 - max 55 znaků  

    • customField4 -  max 55 znaků 

    • customField5 -  max 55 znaků 

    • customField6 -  max 55 znaků 

  • Rozšiřující sloupce (pokud jsou v importu uvedeny, jejich obsah je chápán jako uri adresa na které je otevřeno okno prohlížeče po kliknutí na hodnotu zobrazenou v CTI okně) :

    • nameUri

    • organizationUri

    • customField1Uri

    • customField2Uri

    • customField3Uri

    • customField4Uri

    • customField5Uri

    • customField6Uri

 

Vzor nejmenšího možného CSV souboru :

!!! POZOR !!! phone1 musí být vždy vyplněno jako primární kontaktní číslo !!!

lastName;phone1 "Novák";"+420222333444"