Obsah |
---|
Základní popis
Lze použít libovolnou z níže nabízených metod.
...
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
Informace |
---|
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
Blok kódu |
---|
curl -X POST -H "Content-Type: multipart/form-data" -H "Authorization: Basic <auth>" --form file=@<filename> https://flow.voipex.io/v3/contacts/upload |
...
- 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
Kotva | ||||
---|---|---|---|---|
|
- 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ů.
...
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:
...
V <Error message> bude popis konkrétní chyby.
Import pomocí platformy Integromat
Pro import pomocí Integromatu můžete použít připravený modul IPEX - ImportContacts. Ten umožňuje zpracovat data ve formátu CSV v kódování UTF-8.
Definici CSV datové struktury můžete snadno vytvořit pomocí generátoru, vložením vzorové struktury JSON.
Vzorová struktura (vložte do generátoru a při uložení si ji pojmenujte např. IPEX Contacts CSV structure):
Blok kódu |
---|
{
"firstName" : "Jim",
"lastName" : "Carter",
"nameUri" : "https://crm.company.com/detail/_CONTACTID_",
"organization" : "Big company ltd.",
"organizationUri" : "https://crm.company.com/customer/_ACCOUNTID_",
"externalId" : "101254",
"email" : "person@company.com",
"phone1" : "+420123456789",
"phone2" : "+420123456789",
"agent1" : "20",
"agent2" : "21",
"customField1" : "10%",
"customField1Uri" : "https://crm.company.com/customer/_ACCOUNTID_/discount",
"customField2" : "",
"customField2Uri" : "",
"customField3" : "",
"customField3Uri" : "",
"customField4" : "",
"customField5" : "",
"customField6" : "",
"customField4Uri" : "",
"customField5Uri" : "",
"customField6Uri" : ""
} |
Textový parser musí zkonvertovat oddělovač čárku na středník :
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
Informace |
---|
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 |
...