CDESK komunikuje s ústredňou cez jej rozhranie API. Na to potrebuje vlastné prístupové údaje – API klienta, ktorého vytvorí administrátor ústredne. Skrátený postup nájdete aj priamo v CDESK v karte Ako pripojiť 3CX v nastaveniach VoIP.
Čo budete potrebovať
licenciu 3CX edície AI,
prihlásenie do 3CX Admin Console s rolou System Owner,
ak sú v 3CX zapnuté obmedzenia prístupu podľa IP adresy, povolenú IP adresu servera CDESK.
Vytvorenie API klienta
API Secret je heslo k celej ústredni s právami System Owner, preto ho neposielajte e-mailom v otvorenom texte a po vložení do CDESK ho nikde neuchovávajte. Ak unikne, API klienta v 3CX zmažte a vytvorte nového.
V 3CX Admin Console otvorte Integrations → API a kliknite na Add.
Zadajte jednoznačné Client ID, napríklad cdesk.
Zaškrtnite 3CX Configuration API Access s oddelením System Wide a rolou System Owner.
Zaškrtnite aj 3CX Call Control API Access. Bez neho CDESK nedostáva informácie o hovoroch v reálnom čase a nemôže vytáčať ani presmerovať hovory – po overení pripojenia ukáže len čiastočný stav.
V časti Select extensions vyberte klapky všetkých operátorov, ktorí budú pracovať v CDESK. Ovládanie hovorov vidí len vybrané klapky – klapka, ktorá tu chýba, v CDESK nezvoní v reálnom čase a jej hovory sa doplňujú až z histórie, s oneskorením a bez informácie o rade. Pri každej novej klapke operátora ju preto pridajte aj API klientovi.
Uložte. 3CX zobrazí API Secret iba raz – hneď ho skopírujte. V CDESK ho zadáte do poľa Client Secret.
Adresa ústredne (FQDN)
CDESK potrebuje plnú adresu ústredne, napríklad https://firma.3cx.eu. Nájdete ju v 3CX Admin Console na stránke Dashboard v paneli System Information, riadok 3CX FQDN. 3CX ju zobrazuje bez https:// – CDESK ho doplní sám. Adresa je správna, ak sa na nej otvorí prihlásenie do webového klienta 3CX. Po uložení to overíte aj odkazom 3CX Web Client v hlavičke nastavení VoIP.
Obmedzenia prístupu podľa IP
Ak máte v 3CX zapnuté obmedzenie prístupu do administrácie na vybrané IP adresy (Admin → Advanced → Console Restrictions) alebo zoznam blokovaných adries, povoľte v nich IP adresu servera CDESK. Inak overenie skončí hláškou 3CX odmietla prístup (chyba 403) alebo 3CX ústredňa je nedostupná. Chyba 403 môže znamenať aj nesprávnu rolu API klienta.
3CX chráni administráciu aj pred opakovanými neúspešnými prihláseniami a IP adresu, z ktorej prišli, dočasne zablokuje (po piatich neúspešných pokusoch na 24 hodín). Nesprávne zadaný Client Secret tak môže zablokovať server CDESK. CDESK sa tomu bráni tým, že po zamietnutí údajov ďalšie pokusy na čas pozastaví (pozri Overenie pripojenia). Ak IP adresu servera CDESK už zablokovala ústredňa, treba ju odblokovať v 3CX.
API Secret sa po uložení v CDESK už nezobrazí ani v 3CX. Ak ho stratíte, vytvorte v 3CX nový a v CDESK ho zadajte kliknutím na tlačidlo Zmeniť.