Connecter MikoPBX à Xcellerate OPS : fiche appelant, journal d'appels et click-to-call

Connectez votre propre MikoPBX, sur site ou sur un VPS, à Xcellerate OPS. Les appels entrants affichent le bon contact, chaque appel arrive dans la chronologie CRM du client et votre équipe appelle en un clic depuis OPS.

En bref

• OPS joint votre MikoPBX en HTTPS avec une clé REST API (idéalement aussi un login) et un utilisateur AJAM. Le standard doit être joignable depuis OPS.
• Les appels entrants affichent le contact, les appels sont journalisés dans le CRM, les extensions sont importées et les enregistrements arrivent dans OPS.
• Sans AJAM, pas de click-to-call, et la fiche peut arriver quelques secondes plus tard.

Avant de commencer

Dans MikoPBX :

• HTTPS activé sur l'interface web. Le HTTP simple est refusé.
• Une clé REST API (System → API) de 64 caractères hexadécimaux, avec accès en lecture à sip, employees, cdr et pbx-status. Ou un login et un mot de passe sans double authentification. L'idéal : les deux, car MikoPBX ne fournit le journal d'appels qu'à un utilisateur connecté.
• Un utilisateur manager AJAM (Asterisk Manager Interface ; un utilisateur manager, pas un utilisateur web) avec les classes call, originate, cdr et reporting, et un réseau autorisé qui inclut l'adresse d'OPS. Le port 8089 doit être ouvert en TLS.
• L'enregistrement activé dans MikoPBX si vous voulez les enregistrements dans OPS. OPS n'active jamais l'enregistrement lui-même.

Dans OPS, vous êtes administrateur de l'espace de travail, ou vous avez le droit de gérer les appels au niveau « contribuer ».

Étape 1 : ajoutez MikoPBX dans OPS

Dans OPS, allez dans les paramètres → Données et sécurité → Téléphonie. Sous Ajouter un système téléphonique, choisissez MikoPBX, saisissez un Nom et cliquez sur Ajouter. La connexion démarre désactivée. La carte affiche aussi Notre adresse, pour votre pare-feu : autorisez cette adresse sur votre pare-feu et dans le réseau autorisé de l'utilisateur AJAM.

La page Téléphonie avec « Ajouter un système téléphonique », une liste de systèmes et un champ de nom ; aucun système n'est encore connecté.

Étape 2 : saisissez les données de connexion

Ces champs existent uniquement en anglais :

• PBX address, par exemple https://pbx.example.com
• REST API key et/ou Login et Password
• AJAM manager user et AJAM manager secret
• AJAM address seulement si AJAM tourne sur un autre hôte ou port. Par défaut, OPS utilise le même hôte, port 8089, en HTTPS.

Certificat auto-signé ? Cochez Accepter ce certificat sous cette adresse (enregistré immédiatement ; la connexion reste chiffrée). Cliquez ensuite sur Enregistrer.

Étape 3 : testez la connexion

Cliquez sur Tester la connexion. OPS vérifie dans l'ordre : HTTPS, l'identifiant enregistré, l'API REST, la liste des employés, le journal d'appels et la connexion AJAM. Si AJAM échoue, OPS vérifie si les appels actifs peuvent être interrogés.

Étape 4 : importez les extensions

Cliquez sur Importer les extensions et choisissez la personne sous Appartient à ; OPS propose des correspondances d'après l'adresse e-mail. Pour un groupe d'appel, ajoutez chaque membre comme personne supplémentaire sur la même extension.

Étape 5 : activez et testez

Cliquez sur Activer, puis appelez depuis un numéro enregistré sur un contact.

Ce qui se passe après la connexion

• Appels en direct (standard → OPS). OPS lit les événements de MikoPBX via AJAM par courts intervalles. La zone d'appels en bas à droite montre qui appelle : le contact directement si le numéro correspond exactement, sinon avec un avertissement de supposition. Depuis la fiche, vous ouvrez le contact ou l'entreprise, ajoutez l'appelant ou créez un nouveau ticket pré-rempli avec le numéro (voir le service desk).
• Journal d'appels. Chaque appel terminé est journalisé avec sa durée dans la chronologie CRM du contact et de l'entreprise, et lié à l'affaire ouverte la plus récente (modifiable). Pas de lien automatique avec les tickets. Les numéros inconnus vont dans la liste des appelants inconnus.
• Click-to-call (OPS → standard, via AJAM). Votre poste sonne d'abord, puis le client. L'audio ne passe jamais par OPS.
• Contrôle nocturne. Chaque nuit, OPS complète les appels manquants à partir du journal d'appels, sans doublons.
• Enregistrements : OPS les récupère depuis le journal avec les mêmes identifiants. Chaque écoute ou téléchargement est journalisé.

Bon à savoir

• MikoPBX n'affiche pas le nom de l'appelant sur le poste ; vous le voyez dans OPS.
• Sans AJAM, pas de click-to-call. Si l'interrogation des appels actifs échoue aussi, pas de fiche, mais les appels sont journalisés ensuite.
• Un standard qu'OPS ne peut pas joindre ne peut pas être connecté.
• Les enregistrements ne sont pas supprimés sur le standard.
• Les résumés d'appel par IA sont un interrupteur séparé dans les paramètres IA, désactivé par défaut, qui consomme des crédits IA (voir l'assistance IA).

Dépannage

• Message indiquant que l'adresse n'est pas en HTTPS. Utilisez une adresse en https://.
• MikoPBX refuse la clé API. Vérifiez que les 64 caractères ont été copiés. Un compte avec double authentification ne fonctionne pas. Si seul le journal est refusé, remplissez aussi Login et Password.
• Échec de connexion AJAM. Mauvais secret, ou adresse d'OPS absente du réseau autorisé : consultez le journal du standard. Droits refusés : accordez call, originate, cdr et reporting. Erreur de certificat : cochez Accepter ce certificat sous l'adresse AJAM.

Envie de savoir qui appelle avant de décrocher ? Commencez gratuitement et connectez votre MikoPBX.