CDESK komunikuje s ústřednou prostřednictvím jejího rozhraní API. K tomu potřebuje vlastní přístupové údaje – API klienta, kterého vytvoří správce ústředny. Stručný postup najdete také přímo v CDESK na kartě Jak připojit 3CX v nastavení VoIP.
Co budete potřebovat
licenci 3CX edice AI,
přihlášení do 3CX Admin Console s rolí System Owner,
pokud jsou v systému 3CX zapnuta omezení přístupu podle IP adresy, povolenou IP adresu serveru CDESK.
Vytvoření API klienta
API Secret je heslo k celé ústředně s oprávněními System Owner, proto jej neposílejte e-mailem v otevřeném textu a po zadání do CDESK jej nikde neukládejte. Pokud dojde k jeho úniku, smažte API klienta v 3CX a vytvořte nového.
V administrační konzoli 3CX otevřete sekci Integrations → API a klikněte na Add.
Zadejte jedinečné Client ID, například cdesk.
Zaškrtněte políčko 3CX Configuration API Access s rozdělením System Wide a rolí System Owner.
Zaškrtněte také políčko 3CX Call Control API Access. Bez něj CDESK nedostává informace o hovorech v reálném čase a nemůže vytáčet ani přesměrovávat hovory – po ověření připojení zobrazí pouze částečný stav.
V části „Select extensions“ vyberte klapky všech operátorů, kteří budou pracovat v CDESK. Ovládání hovorů vidí pouze vybrané klapky – klapka, která zde chybí, v CDESK nezvoní v reálném čase a její hovory se doplňují až z historie, se zpožděním a bez informace o frontě. Při přidání každé nové klapky operátora ji proto přidejte také do API klienta.
Uložte. 3CX zobrazí API Secret pouze jednou – ihned si jej zkopírujte. V CDESK jej zadáte do pole Client Secret.
Adresa ústředny (FQDN)
CDESK potřebuje úplnou adresu ústředny, například https://firma.3cx.eu. Najdete ji v 3CX Admin Console na stránce Dashboard v panelu System Information, v řádku 3CX FQDN. 3CX ji zobrazuje bez https:// – CDESK ji doplní sám. Adresa je správná, pokud se na ní otevře přihlašovací stránka do webového klienta 3CX. Po uložení to ověříte také pomocí odkazu 3CX Web Client v záhlaví nastavení VoIP.
Omezení přístupu podle IP adresy
Pokud máte v systému 3CX zapnuté omezení přístupu do administrace na vybrané IP adresy (Admin → Advanced → Console Restrictions) nebo seznam blokovaných adres, povolte v nich IP adresu serveru CDESK. V opačném případě bude ověření ukončeno hláškou „3CX odmítla přístup (chyba 403)“ nebo „Ústředna 3CX je nedostupná“. Chyba 403 může také znamenat nesprávnou roli API klienta.
3CX chrání administraci také před opakovanými neúspěšnými pokusy o přihlášení a IP adresu, ze které tyto pokusy přišly, dočasně zablokuje (po pěti neúspěšných pokusech na 24 hodin). Nesprávně zadaný Client Secret tak může zablokovat server CDESK. CDESK tomu zabraňuje tím, že po zamítnutí údajů dočasně pozastaví další pokusy (viz Ověření připojení). Pokud IP adresu již zablokovala ústředna, je třeba ji odblokovat v 3CX.
API Secret se po uložení v CDESK již nezobrazí ani v 3CX. Pokud jej ztratíte, vytvořte v 3CX nový a v CDESK jej zadejte kliknutím na tlačítko Změnit.