Connecter Asterisk à Xcellerate OPS : identification, clic pour appeler et journal

Connectez votre Asterisk à Xcellerate OPS : vous voyez qui appelle, chaque appel arrive sur la timeline CRM du client et votre équipe appelle directement depuis OPS. Ce guide s'adresse aux administrateurs de MSP et de PME de services qui gèrent eux-mêmes un Asterisk (version 16 ou plus).

TL;DR

• OPS se connecte à votre Asterisk via AJAM en HTTPS, avec un utilisateur manager qui n'accepte que l'adresse d'OPS.
• Fenêtre d'appel entrant, clic pour appeler (votre poste sonne d'abord) et journal des appels sur la timeline CRM.
• En option : enregistrements depuis un dossier HTTPS protégé et réconciliation nocturne avec votre base CDR.

Avant de commencer

• Vous êtes administrateur de l'espace OPS, ou votre rôle permet de gérer la téléphonie.
• Un administrateur Asterisk qui peut modifier http.conf, manager.conf et le dialplan. Asterisk 16 ou plus ; l'extrait de dialplan est testé sur 18 et 20.
• OPS doit pouvoir joindre votre Asterisk en HTTPS. Un PBX injoignable ne peut pas encore être connecté.
• L'adresse d'OPS pour votre pare-feu, affichée sur la page de téléphonie.

La téléphonie est une fonction de base, incluse dans tous les abonnements.

Étape 1 : préparez Asterisk

AJAM en HTTPS

Dans http.conf :

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Un utilisateur manager pour OPS

Dans manager.conf, créez un utilisateur avec un long secret, limité à l'adresse d'OPS :

deny = 0.0.0.0/0.0.0.0
permit = <adresse OPS>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Autorisez l'adresse d'OPS vers ce port dans votre pare-feu.

En option : enregistrements et CDR

• Ajoutez les macros d'enregistrement d'OPS (ops-recording et ops-hangup) de l'extrait de dialplan publié à vos contextes entrants et sortants. Ne changez pas le nom des fichiers.
• Servez le dossier monitor (/var/spool/asterisk/monitor) en lecture seule via HTTPS, avec authentification basic et liste d'IP autorisées.
• Pour la réconciliation : un accès en lecture à votre base CDR, par exemple mysql:host=…;dbname=asteriskcdrdb, table cdr.

OPS n'active jamais l'enregistrement. Si vous devez l'annoncer, faites-le dans le dialplan, avant le début de l'enregistrement. Rechargez Asterisk.

Étape 2 : ajoutez Asterisk dans OPS

Ouvrez les réglages de téléphonie (Settings → Data and security → Telephony), cliquez sur Ajouter un système téléphonique, choisissez Asterisk et donnez un nom.

La page Téléphonie avec une liste déroulante de systèmes téléphoniques, un champ de nom et le message indiquant qu'aucun système n'est encore connecté.

Remplissez Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret. Pour les enregistrements : Recordings base URL, Recordings user, Recordings password. Pour la réconciliation : CDR database DSN, CDR database user, CDR database password. Avec un certificat autosigné, cochez Accepter ce certificat. Enregistrez.

Étape 3 : testez, associez les postes et activez

1. Cliquez sur Tester la connexion. Vous voyez si le PBX répond via AJAM et si une source d'enregistrements est configurée.
2. Les postes ne sont pas importés. Saisissez chaque poste et choisissez dans Appartient à qui l'utilise. Pour un groupe d'appel, ajoutez chacun avec Ajouter une personne. Un poste sans personne n'affiche rien.
3. Cliquez sur Activer et passez un appel de test.

Ce qui se passe après la connexion

• Appels entrants : OPS lit les événements d'Asterisk par courtes tranches. En bas à droite, vous voyez qui appelle, avec des boutons pour ouvrir le contact ou la société, créer un ticket prérempli avec le numéro ou ajouter le numéro comme contact. Un appel transféré reste un seul appel.
• Clic pour appeler : avec un poste personnel (pas un groupe), Asterisk fait d'abord sonner votre poste, puis le client. OPS ne transporte pas l'audio. Ensuite, vous notez le résultat.
• Journal : chaque appel arrive sur la timeline CRM du contact et de la société, lié à l'opportunité ouverte la plus récente. Pas sur les tickets. Les numéros inconnus vont dans une liste à part ; OPS ne crée jamais de contact tout seul.
• Appels manqués : notification à la personne dont le poste a sonné, sinon au responsable de l'opportunité.
• Enregistrements : récupérés après l'appel, liés au bon appel et écoutés dans OPS, avec un journal des écoutes. Les appels manqués ne sont pas récupérés.
• Réconciliation : avec une base CDR, OPS complète chaque nuit.

Bon à savoir

• HTTPS uniquement : OPS n'envoie jamais les identifiants manager en HTTP simple.
• Les enregistrements sont récupérés uniquement depuis un dossier HTTPS.
• OPS lance les appels sortants dans le contexte from-internal.
• L'enregistrement sur deux canaux double l'espace disque, mais permet aux résumés d'appel de distinguer appelant et agent. Les résumés d'appel sont désactivés par défaut (réglages IA) et consomment des crédits IA.
• OPS ne supprime pas les enregistrements sur votre Asterisk. Le secret manager n'est plus lisible après l'enregistrement.

Dépannage

• "The base URL is not HTTPS." Placez le point d'accès AJAM derrière TLS.
• "The PBX did not answer over AJAM: …" Vérifiez que l'utilisateur manager existe, que sa ligne permit contient l'adresse d'OPS et que le port lui est ouvert.
• "No recording source is configured." Servez le dossier monitor en HTTPS protégé et appliquez l'extrait de dialplan.
• Aucun enregistrement, aucune erreur : le nom de fichier a été modifié dans le dialplan.

Lancez-vous

Faites travailler votre Asterisk avec votre CRM et votre service desk. Commencez gratuitement. Découvrez aussi les intégrations européennes d'OPS et ventes et facturation.