Průvodce Mokapenem

3CX

3CX propojuje ústřednu s Mokapen pro popup kontaktu, deník hovorů a, pokud to nastavíte, click-to-call. Mokapen se nestane ústřednou: generuje API klíč a XML šablonu, kterou nahrajete v adminu 3CX. Odtud 3CX ptá Mokapen, kdo je číslo, a Mokapen může zapsat poznámku hovoru na kontakt nebo firmu.

Přehled: Integrace.

Požadavky

• Instalace 3CX, kde můžete otevřít Admin → Integrations → CRM a nahrát šablonu.
• Plán Mokapen Medium.
• Pro click-to-call navíc: plán 3CX s Call Control / WebAPI (Enterprise), host 3CX dosažitelný z Mokapen a přípona mapovaná na uživatele, který kliká.

API klíč a šablona

Uživatelské menu → Integrace → 3CX. Mokapen ukáže API klíč k použití v CRM šabloně: jako uživatelské jméno Basic auth, nebo v hlavičce X-Api-Key. Stáhněte XML šablonu. Klíč je už vložen jako výchozí hodnota. Nahrajte ji v 3CX Admin → Integrations → CRM.

Na stránce najdete i základní URL CRM API: je to adresa, kterou šablona volá. Pokud je 3CX za sítí, která nedosáhne Mokapen, popup se neotevře ani s nahranou šablonou.

Klíč můžete při uložení regenerovat. Předchozí přestane platit: je třeba znovu nahrát šablonu, nebo aktualizovat klíč už vložený v 3CX. Ponechání starého klíče v ústředně způsobí chyby autentizace, ne druhé připojení.

Poznámky hovorů a click-to-call

Dva přepínače rozhodují o chování vůči adresáři:

• Ukládat poznámky hovorů na kontakty a firmy — na konci hovoru Mokapen zapíše poznámku na nalezenou kartu.
• Povolit vytváření kontaktů z 3CX, pokud je číslo neznámé — pokud číslo v adresáři není, Mokapen kontakt vytvoří. Vypněte to, pokud ústředna přijímá obecný provoz (ústředna sídla, zdvořilostní čísla): jinak se z každého neznámého stane karta.

Click-to-call je oddělený. Potřebujete host 3CX (FQDN) a klíč WebAPI / Call Control. Bez klíče Mokapen říká, že klíč Call Control není nastaven. Bez hostu říká, že chybí FQDN. Bez mapování hovor neví, kterou příponu vyzvánět.

Mapování je jeden řádek na osobu ve tvaru přípona=user_id (příklad 102=15). Slouží jak k přiřazení poznámky hovoru správnému uživateli, tak k click-to-call. Pokud váš uživatel nemá řádek, Mokapen říká, že není mapovaná přípona. Běžný klik volá přes 3CX; Shift, Ctrl nebo Alt spolu s klikem otevře dialer zařízení.

Pokud 3CX požadavek odmítne, zkontrolujte v pořadí FQDN, klíč Call Control a příponu. Zpráva na stránce je, že 3CX hovor nepřijal.

Když popup nevyjde

• Šablona nebyla nahrána, nebo byla nahrána před regenerací klíče.
• Příchozí číslo neodpovídá telefonu v adresáři a automatické vytváření je vypnuté. Popup nemá kartu k otevření.
• Hledáte videohovor schůzky. 3CX nedává Meet ani Teams na kartu schůzky.