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 |
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 |
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 :
Pro konverzi řetězce na Base64 string můžete použít developerskou konzoli vašeho browseru (doporučen Chrome, ale není podmínkou) :
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" |
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).
{ "message":"uploaded","error":"" } |
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. <Error message> |
V <Error message> bude popis konkrétní chyby.
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 :
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.
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 |