fr uk en kn fa fr en en en ta en fr cs cs cs en fr en id en en en fr en fr en cs fr es cs cs cs en fi en en en en en en en fr fr cs en en fr cs fr en id en en en en en cs cs cs cs hbs_lat cs cs cs cs cs cs cs cs cs cs cs cs cs nds cs cs cs cs cs en cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs cs ms en en pt pt en en en cs cs en cs en cs cs cs cs en cs cs cs hsb en cs cs cs cs cs cs cs cs en en cs cs nds cs cs en
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
Povinné údaje v dané sekci
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
je povinné alespoň jedno telefonní číslo. Minimálně musí být vždy vyplněno phone1
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
tyto údaje lze následně zobrazovat v CTI okně při příchozím hovoru
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  " --form file=@  https://flow.voipex.io/v3/contacts/upload
V příkazovém řádku upravte :
- 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==  )
- 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
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ů.
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ě) :
Vzor nejmenšího možného CSV souboru :
!!! POZOR !!! phone1 musí být vždy vyplněno jako primární kontaktní číslo !!!
Vzor maximálního možného CSV souboru :
firstName;lastName;organization;externalId;email;phone1;phone2;agent1;agent2;customField1;customField2;customField3;customField4;customField5;customField6;organizationUri "Jan";"Novák";"IPEX a.s.";"36936";"jan@novak.com";"+420222333444";"+420777711100";"22";"100";"VIP";"Mikuš";"Helpdesk";"323";"2000";"0";"https://nase.aplikace.cz/account/12123" "Ivan";"Neúplný";;"1";;"+420222333444";"+420777711100";"22";"100";"VIP";"Mikuš";"Helpdesk";"323";"2000";"0";"https://nase.aplikace.cz/account/35873"
V uvedené ukázce jsou  např. customFields zamýšleny jako Důležitost, Obchodník, Technik, Středisko, Tržba a Dluh.
Na druhém řádku je ukázka formátu, pokud v některých sloupcích nejsou data předána (zůstanou jen dva středníky).
Informace o výsledku importu
Při úspěšném dokončení importu:
Pokud je vráceno error: "" znamená to že nebyla nalezena žádná chyba.
Řádky, kde je reportována chyba NEJSOU naimportovány a je nutno import opakovat po opravě zdrojového csv souboru.
Řádek může být odmítnut i z důvodu, že importované číslo neodpovídá požadavkům mezinárodního formátu kontrolovaného výš uvedenou knihovnou.
Error on line number x occured.
V   bude popis konkrétní chyby.
Import pomocí platformy Integromat
Pro import pomocí Integromatu můžete použít připravený modul IPEX Update Contacts (zjednodušuje výrazně propojení systémů proti staršímu modulu IPEX - ImportContacts. POZOR nezaměňovat s modulem IPEX Update Contact, který provádí  update jen jediného kontaktu, zatímco Update Contacts provádí hromadný import/aktualizaci kontaktů)
Kontakty můžete exportovat z vašeho systému :
modulem na výpis kontaktů, pokud pro váš systém existuje v Integromatu podpora
modulem obecného HTTP požadavku, kterým si můžete zavolat REST API vašeho systému, čímž lze napojit téměř všechny systémy
Například pro načtení kontaktů ze služby People365 to lze zajistit následovně :
Kde v modulu IPEX Update Contacts provedete mapování výstupu z modulu Array aggregator a v něm si lehce nadefinujete položky, které chcete zobrazovat v CRM okně při příchozím hovoru a jako identitu v panelech a statistikách Callcentra  :
Místo modulu People365, můžete volat RESTAPI vašeho systému pomocí obecného modulu HTTP :
S nastavením a dalšími možnostmi vám poradí naši konzultanti.
Import dat pomocí REST API
Tato metoda je preferována pro import změn nebo postupný import velkého množství dat (předpokládá se naprogramování klienta na straně zákazníka)
Doporučená implementace by měla používat verzi v3/contacts  z dokumentace https://flow.voipex.io/documentation