CallerHub
FR
Download

Asterisk, FreePBX, VitalPBX et Issabel : identification de l’appelant par HTTP

Asterisk définit le nom de l’appelant dans le plan de numérotation. C’est vous qui décidez d’où vient le nom : une recherche HTTP à chaque appel, qui le renvoie depuis votre CRM, votre base de données ou votre annuaire.

Comment Asterisk recherche un nom

  • Asterisk directement : dans le contexte entrant, la fonction CURL (module func_curl) appelle une adresse ; le résultat est écrit dans CALLERID(name) avant que le téléphone sonne.
  • FreePBX et Issabel : le module CallerID Lookup Sources accepte une source HTTP avec hôte, port, chemin et requête. Les détails figurent dans la documentation Sangoma.
  • VitalPBX : une source de recherche CID (HTTP/HTTPS) dans la route entrante.

Gardez un délai d’attente court : si le service ne répond pas, l’appel doit quand même sonner immédiatement. Avec HTTPS, Asterisk doit faire confiance au certificat du service (enregistrez le certificat racine sur le serveur Asterisk).

Avec CallerHub : l’adresse pour votre système téléphonique

Dans CallerHub, créez une interface pour votre système téléphonique sous Interfaces → Ajouter une interface, saisissez l’adresse du serveur Asterisk sous Adresses IP autorisées et choisissez Enregistrer et appliquer. « Copier les instructions » fournit l’adresse complète avec la vraie clé API. Les exemples utilisent 192.168.10.5 comme ordinateur CallerHub et l’espace réservé API-KEY.

Système téléphoniqueRequête à saisir
Asterisk / FreePBX (plan de numérotation)…/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})}
FreePBX / Issabel (CallerID Lookup Sources)chemin /lookup, requête format=text&apikey=…&number=[NUMBER]
VitalPBX (source de recherche CID)…/lookup?apikey=…&number=[CIDNUM]

Exemple de plan de numérotation (FreePBX : extensions_custom.conf, contexte from-pstn-custom ou similaire)

exten => _X.,1,Set(CURLOPT(httptimeout)=2)
 same => n,Set(CALLERID(name)=${CURL(http://192.168.10.5:8080/lookup?apikey=API-KEY&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})})})
 same => n,Goto(from-pstn,${EXTEN},1)

Rechargez ensuite le plan de numérotation (dialplan reload). Si CallerHub est injoignable, le nom reste vide au bout de 2 secondes et l’appel se poursuit normalement. called transmet le numéro appelé pour les statistiques.

Analyse des appels via AMI ou Master.csv

Pour le taux de décroché et le niveau de service, la liste de rappels et la vue en direct, CallerHub lit les journaux d’appels :

  • En direct via AMI : CallerHub se connecte au port 5038. Créez un utilisateur avec read = cdr dans manager.conf et définissez enabled = yes dans cdr_manager.conf.
  • Fichier : Master.csv du module CDR d’Asterisk, également pour les appels antérieurs.
Analyse des appels
Analyse des appels des 30 derniers jours avec les chiffres des appels, le taux de décroché, le niveau de service, le taux de rappel et les rappels en attente.

Erreurs fréquentes

SymptômeCause et solution
Le nom reste vide, CallerHub n’affiche aucune requêteLa requête n’atteint pas CallerHub : vérifiez l’adresse, le port, le pare-feu Windows et les pare-feu entre les réseaux ; testez depuis le serveur Asterisk avec curl. func_curl est-il chargé ?
Journal : status=401 ou 403Clé API erronée, ou l’adresse du serveur Asterisk ne fait pas partie des adresses IP autorisées. Derrière un NAT, l’émetteur est différent.
La requête arrive, mais sans nomNuméro inconnu (testez avec « Vérifier le numéro »), format erroné, ou délai d’attente plus court que le temps de réponse.
Trémas ou accents mal affichésLes réponses sont en UTF-8 ; vérifiez le jeu de caractères du système téléphonique.

Les guides pour Asterisk, FreePBX, VitalPBX et Issabel reposent sur des interfaces publiées et n’ont pas encore été vérifiés avec ces systèmes. Vérifiez les espaces réservés, les chemins de menu et les noms de réglages dans la documentation de votre version.

Questions fréquentes

Quel format de réponse Asterisk attend-il ?

Du texte brut : uniquement le nom, vide pour les numéros inconnus. C’est le réglage par défaut de CallerHub pour Asterisk, FreePBX, VitalPBX et Issabel ; avec format, vous pouvez aussi choisir JSON ou XML.

La recherche ralentit-elle l’appel ?

CallerHub répond aux appels à partir de la liste de numéros en mémoire ; une base de données lente ne retarde donc pas la réponse. Le délai d’attente dans le plan de numérotation limite en outre l’attente, à 2 secondes dans l’exemple.

Puis-je connecter plusieurs serveurs Asterisk ?

Oui. Chaque système téléphonique obtient sa propre interface avec sa propre clé API, ses propres adresses IP autorisées et sa propre sélection de sources de données. L’édition de base permet une interface, l’édition complète jusqu’à dix.

Essayer

Testez avec vos propres données.

Testez l’édition complète pendant 30 jours : demandez la période d’essai dans CallerHub, la clé d’essai arrive par e-mail. L’assistant de configuration vous guide à travers source de données, système téléphonique et recherche de test. Ensuite, CallerHub continue en édition de base gratuite, sans perdre réglages ni données.