Apprendre mokapen

3CX

3CX connecte le central à Mokapen pour le popup du contact, le journal des appels et, si vous le configurez, le click-to-call. Mokapen ne devient pas le central : il génère une clé API et un modèle XML que vous chargez dans l'admin 3CX. De là, 3CX demande à Mokapen qui est le numéro, et Mokapen peut écrire la note d'appel sur le contact ou l'entreprise.

Vue d'ensemble : Intégrations.

Prérequis

• Une installation 3CX dont vous pouvez ouvrir Admin → Integrations → CRM et charger un modèle.
• Plan Mokapen Medium.
• Pour le click-to-call, en plus : plan 3CX avec Call Control / WebAPI (Enterprise), un hôte 3CX joignable depuis Mokapen, et un interne mappé à l'utilisateur qui clique.

Clé API et modèle

Menu utilisateur → Intégrations → 3CX. Mokapen montre la clé API à utiliser dans le modèle CRM : comme nom d'utilisateur de la Basic auth, ou dans l'en-tête X-Api-Key. Téléchargez le modèle XML. La clé est déjà insérée comme valeur par défaut. Chargez-le dans 3CX Admin → Integrations → CRM.

Sur la page vous trouvez aussi l'URL de base des API CRM : c'est l'adresse que le modèle appelle. Si 3CX est derrière un réseau qui n'atteint pas Mokapen, le popup ne s'ouvre pas même avec le modèle chargé.

Vous pouvez régénérer la clé à l'enregistrement. La précédente cesse de valoir : il faut recharger le modèle, ou mettre à jour la clé déjà collée dans 3CX. Laisser l'ancienne clé dans le central produit des erreurs d'authentification, pas un second branchement.

Notes d'appel et click-to-call

Deux interrupteurs décident le comportement vers le carnet :

• Enregistrer les notes d'appel sur contacts et entreprises — en fin d'appel, Mokapen écrit la note sur la fiche trouvée.
• Autoriser la création de contacts depuis 3CX si le numéro est inconnu — si le numéro n'est pas dans le carnet, Mokapen crée le contact. Éteignez-le si le central reçoit du trafic générique (central de site, numéros de politesse) : sinon chaque inconnu devient une fiche.

Le click-to-call est séparé. Il faut l'hôte 3CX (FQDN) et la clé WebAPI / Call Control. Sans clé, Mokapen dit que la clé Call Control n'est pas configurée. Sans hôte, qu'il manque le FQDN. Sans mapping, l'appel ne sait pas quel interne faire sonner.

Le mapping est une ligne par personne, sous la forme interne=user_id (exemple 102=15). Il sert à la fois à attribuer la note d'appel au bon utilisateur et pour le click-to-call. Si votre utilisateur n'a pas de ligne, Mokapen dit qu'il n'y a pas d'interne mappé. Le clic normal appelle avec 3CX ; Maj, Ctrl ou Alt avec le clic ouvre le composeur de l'appareil.

Si 3CX refuse la demande, vérifiez dans l'ordre FQDN, clé Call Control et interne. Le message sur la page est que 3CX n'a pas accepté l'appel.

Quand le popup ne sort pas

• Le modèle n'a pas été chargé, ou il a été chargé avant la régénération de la clé.
• Le numéro entrant ne correspond à aucun téléphone du carnet et la création automatique est éteinte. Le popup n'a pas de fiche à ouvrir.
• Vous cherchez l'appel vidéo du rendez-vous. 3CX ne met pas Meet ou Teams sur la fiche rendez-vous.