Ghidul Mokapen

3CX

3CX leagă centrala de Mokapen pentru popup-ul contactului, jurnalul apelurilor și, dacă îl configurezi, click-to-call. Mokapen nu devine centrala: generează o cheie API și un template XML pe care le încarci în admin 3CX. De acolo 3CX întreabă Mokapen cine este numărul, iar Mokapen poate scrie nota de apel pe contact sau companie.

Prezentare: Integrări.

Cerințe

• O instalare 3CX în care poți deschide Admin → Integrations → CRM și încărca un template.
• Plan Mokapen Medium.
• Pentru click-to-call, în plus: plan 3CX cu Call Control / WebAPI (Enterprise), un host 3CX accesibil din Mokapen, și un intern mapat la utilizatorul care dă clic.

Cheie API și template

Meniu utilizator → Integrări → 3CX. Mokapen arată cheia API de folosit în template-ul CRM: ca username pentru Basic auth, sau în header-ul X-Api-Key. Descarcă template-ul XML. Cheia este deja inserată ca valoare implicită. Încarcă-l în 3CX Admin → Integrations → CRM.

În pagină găsești și URL-ul de bază al API-urilor CRM: este adresa pe care o apelează template-ul. Dacă 3CX este în spatele unei rețele care nu ajunge la Mokapen, popup-ul nu se deschide nici cu template-ul încărcat.

Poți regenera cheia la salvare. Cea anterioară încetează să mai fie valabilă: trebuie reîncărcat template-ul, sau actualizată cheia deja lipită în 3CX. Lăsarea cheii vechi în centrală produce erori de autentificare, nu o a doua conectare.

Note de apel și click-to-call

Două comutatoare decid comportamentul față de agendă:

• Salvează note de apel pe contacte și companii — la finalul apelului Mokapen scrie nota pe cardul găsit.
• Permite crearea de contacte din 3CX dacă numărul este necunoscut — dacă numărul nu este în agendă, Mokapen creează contactul. Oprește-l dacă centrala primește trafic generic (centrală de sediu, numere de curtoazie): altfel fiecare necunoscut devine un card.

Click-to-call este separat. Sunt necesare host 3CX (FQDN) și cheie WebAPI / Call Control. Fără cheie, Mokapen spune că cheia Call Control nu este configurată. Fără host, spune că lipsește FQDN. Fără mapare, apelul nu știe ce intern să sune.

Maparea este un rând pe persoană, în forma interno=user_id (exemplu 102=15). Servește atât pentru a atribui nota de apel utilizatorului potrivit, cât și pentru click-to-call. Dacă utilizatorul tău nu are un rând, Mokapen spune că nu există un intern mapat. Clicul normal apelează cu 3CX; Shift, Ctrl sau Alt împreună cu clic deschide dialerul dispozitivului.

Dacă 3CX respinge cererea, verifică în ordine FQDN, cheia Call Control și internul. Mesajul din pagină este că 3CX nu a acceptat apelul.

Când popup-ul nu apare

• Template-ul nu a fost încărcat, sau a fost încărcat înainte de regenerarea cheii.
• Numărul care intră nu coincide cu un telefon din agendă și crearea automată este oprită. Popup-ul nu are un card de deschis.
• Cauți apelul video al programării. 3CX nu pune Meet sau Teams pe cardul de programare.