CallerHub
FR
Download

Téléphonie et connexions

CallerHub se connecte aux systèmes téléphoniques de quatre façons : par une recherche HTTP à chaque appel, comme annuaire LDAP, par des annuaires exportés et – pour l’analyse – par les journaux d’appels.

Guides pas à pas : STARFACE · 3CX · Asterisk/FreePBX · Yealink/Snom · Mitel 100 · FRITZ!Box · toutes les solutions

Recherche de nom par HTTP

Chaque système téléphonique est connecté comme interface distincte, avec sa clé API et ses adresses IP autorisées. L’édition de base permet une interface, l’édition complète jusqu’à dix (plus avec une licence spéciale). Tous les systèmes utilisent le même port ; CallerHub les distingue par leur clé API.

Système ou profilFormat de réponseAdresse d’exempleMise en placeStatut
STARFACETexte…/lookup?number= + en-tête X-Api-Keypar un module STARFACE ; module d’exemple CallerHub_Interface_v49.sfm fournitesté
3CXJSON…/lookup?format=json&apikey=…&number=[Number]modèle CRM généré par CallerHub (« Modèle 3CX … »)Testeurs recherchés
Asterisk / FreePBXTexte…/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})}plan de numérotation avec CURL (module func_curl)Testeurs recherchés
VitalPBXTexte…/lookup?apikey=…&number=[CIDNUM]source de recherche CID dans la route entranteTesteurs recherchés
Issabel (aussi FreePBX)Textechemin /lookup, requête format=text&apikey=…&number=[NUMBER]CallerID Lookup SourcesTesteurs recherchés
Yealink / FanvilAnnuaire XML…/lookup?format=yealink&apikey=…&number=#SEARCHannuaire distant sur le téléphone ou par provisionnementTesteurs recherchés
SnomAnnuaire XML…/lookup?format=snom&apikey=…&number=#SEARCHannuaire XML sur le téléphoneTesteurs recherchés
Générique (HTTP)Texte, JSON, XML…/lookup?format=json&apikey=…&number=03023125017tout système capable d’appeler une adresse en HTTP GET lors d’un appelgénérique

Testés : la connexion STARFACE, la connexion CSTA des Mitel 100, Aastra et OpenCom, les téléphones Mitel 6800/6900 et la FRITZ!Box. Les guides des autres systèmes reposent sur des interfaces publiées ; vérifiez espaces réservés, chemins de menu et noms de réglages dans la documentation de votre version.

Votre système n’est pas encore testé ? Devenez client pilote – 12 mois d’édition complète gratuits.

Une carte par système téléphonique

Sur la page Interfaces, chaque système a sa carte avec nom, statut de la dernière requête, clé API, adresses IP autorisées et sources interrogées. « Copier le guide » fournit le guide de mise en place du système choisi avec la vraie clé API.

Page Interfaces avec la carte du système téléphonique dépliée.
Page Interfaces : une carte par système téléphonique.
Carte Système téléphonique avec le guide pour STARFACE.
Carte « Système téléphonique » avec le guide pour STARFACE.

Exemple Asterisk / FreePBX

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)

Exemple Yealink (provisionnement)

remote_phonebook.data.1.url = http://192.168.10.5:8080/lookup?format=yealink&apikey=API-KEY&number=#SEARCH
remote_phonebook.data.1.name = CallerHub
features.remote_phonebook.enable = 1

Module STARFACE

STARFACE n’a pas de recherche de nom intégrée par adresse web ; un module du Module Designer demande le nom à CallerHub à chaque appel entrant. Pour cela, importez Samples\CallerHub_Interface_v49.sfm ; ce module gère la recherche de nom. Un module étendu signale aussi tous les événements d’un appel (sonnerie, décroché, raccroché, transféré) pour l’analyse, les statistiques et la vue en direct ; détails sur demande auprès du support. Les appels anonymes ne sont pas recherchés.

Annuaire LDAP pour les systèmes sans recherche HTTP

Beaucoup de systèmes et de téléphones de bureau n’interrogent pas une adresse web mais un annuaire LDAP. Pour eux, le module Annuaire fournit un annuaire LDAPv3 en lecture seule (port 389, 636 avec LDAPS). La recherche inverse des appels entrants interroge toutes les sources actives, règles, listes de blocage et VIP comprises.

Appareils typiques : Unify OpenScape Business, Auerswald COMtrexx/COMpact, Avaya J100 sur IP Office, Yeastar série P, innovaphone (recherche inverse), Ascom IP-DECT, Grandstream UCM, pascom, Gigaset, Yealink et la famille Mitel 100 (Mitel 112, 130, 150).

Carte Annuaire avec annuaire LDAP, guide par appareil et export.
Interfaces → Annuaire : annuaire LDAP, guide par appareil et export.
Serveur :          nom ou adresse IP de l’ordinateur CallerHub, port 389 (636 avec LDAPS)
Base DN:           ou=callerhub
Filtre nom :       (|(cn=%)(sn=%))
Filtre numéro :    (|(telephoneNumber=%)(mobile=%))
Attribut affiché : cn          Attribut numéro : telephoneNumber

Les tentatives d’écriture sont refusées, StartTLS n’est pas pris en charge. La connexion LDAP de la famille Mitel 100 est testée avec CallerHub.

Export d’annuaire et FRITZ!Box

Les téléphonies cloud comme Microsoft Teams, Zoom, NFON ou Placetel et la FRITZ!Box utilisent leurs propres listes de contacts. Pour elles, CallerHub exporte les entrées de toutes les listes de numéros (après règles, sans numéros bloqués).

FormatUsage
FRITZ!Box (XML)FRITZ!Box : Téléphonie → Annuaire → Restaurer. Le nombre d’entrées est limité selon le modèle.
vCard 3.0 (.vcf)Outlook, Auerswald, Gigaset et de nombreuses téléphonies cloud
CSVExcel et import dans les téléphonies cloud (p. ex. Zoom, NFON, Placetel)
Yealink (XML)Annuaire distant pour Yealink et téléphones compatibles

Les téléphones avec annuaire distant peuvent aussi charger la liste directement : /phonebook?format=yealink&key=ACCESS_KEY (formats yealink, fritzbox, vcard, csv). Pour l’analyse, CallerHub lit le moniteur d’appels de la FRITZ!Box sur le port 1012.

Synchroniser le carnet d’adresses STARFACE

Pour les appels sortants, l’application STARFACE, le client web et les listes d’appels n’affichent que les noms des carnets STARFACE. CallerHub écrit donc les contacts de ses listes de numéros dans un carnet dédié via l’API REST STARFACE – chaque nuit à l’heure réglée, après chaque rechargement des sources et d’un simple clic.

  • Uniquement dans son propre carnet : CallerHub ne crée, modifie et supprime des entrées que là. Si une source est vide ou a diminué de plus de moitié, il ne supprime rien.
  • Aucun accès entrant nécessaire : la connexion va de CallerHub vers le système téléphonique ; avec OAuth à partir de STARFACE 10.
  • Gros volumes par étapes : limites par passage et pour tout le carnet, choix des sources.
Interfaces · annuaire et carnet d’adresses
Page Interfaces avec les cartes Système téléphonique et Annuaire.

Provisionner les téléphones Mitel (6800/6900)

Le module de provisionnement fournit aux téléphones Mitel leurs réglages via HTTP et TFTP – poste, compte SIP, touches et pages – et affiche infos d’appel, recherche CRM et page d’équipe à l’écran.

  • Téléphones en tableau : MAC, modèle, poste, nom ; la colonne d’état montre quand le téléphone a récupéré son fichier pour la dernière fois.
  • Touches pour tous : supervision, numérotation abrégée, messagerie, fonctions ou nouvelle page – triées par glisser.
  • Page d’équipe : la touche « Team » montre les collègues avec leur état (en ligne, sonne, libre) ; en choisir un l’appelle.

STARFACE Cloud ne répond pas aux abonnements de supervision des téléphones tiers ; les touches de collègues peuvent alors être des numérotations abrégées, et la page d’équipe montre quand même l’état.

Journaux d’appels pour l’analyse

L’analyse a besoin des journaux détaillés (CDR) du système téléphonique. Ils arrivent à CallerHub sous forme de fichier, en direct par une connexion ou via une API. Jusqu’à cinq récepteurs en direct sont possibles.

Schéma : les journaux arrivent à CallerHub par socket/TCP, par des connexions établies par CallerHub, par interrogation d’API et par HTTP ; CallerHub en alimente l’analyse et les événements d’appel.
Chemins des journaux d’appels vers CallerHub (schéma de l’aide CallerHub, en allemand).
SourceCheminRéglage dans le système téléphonique
Asterisk / FreePBXFichier Master.csv ou en direct via AMI (CallerHub se connecte, port 5038)manager.conf : utilisateur avec read = cdr; cdr_manager.conf: enabled = yes
STARFACEFichier output.csvAdmin → Rapports → Exporter les journaux d’appels
3CX (v18/v20)Socket CDR actif (CallerHub écoute, p. ex. port 5100) ou passif ; export CSVAdmin → Settings → CDR
3CX V20 (cloud ou sur site)API : CallerHub interroge XAPIIntégrations → API : client avec accès XAPI
Microsoft Teams PhoneAPI : Microsoft Graph, autorisation CallRecords.Read.AllInscription d’application dans Microsoft Entra ID
Webex CallingAPI: analytics.webexapis.com, scope spark-admin:calling_cdr_readControl Hub : rôle « Detailed Call History API access »
Mitel MiVoice Office 400SMDR au format PC5, CallerHub se connecte (port 1080)Sortie des journaux d’appels via TCP
Unify OpenScape BusinessDonnées de taxation via LAN, CallerHub écoute (p. ex. port 5101)Client TCP vers adresse:port de CallerHub
innovaphoneTCP ou HTTP /cdrGateway → CDR0
FRITZ!BoxMoniteur d’appels, CallerHub se connecte (port 1012)composer une fois #96*5* sur un téléphone
PlacetelHTTP /eventAPI Notify avec l’adresse de CallerHub
sipgate.ioHTTP /eventURL pour appels entrants et sortants
Tout système ou scriptHTTP ou fichier CSV dans le dossier CallDatadétails sur demande auprès du support

Mise en place en cinq étapes

  1. Sous Interfaces, ajoutez une interface, choisissez le système téléphonique et saisissez un nom.
  2. Sous « Adresses IP autorisées », saisissez l’adresse du système ou le réseau des téléphones, p. ex. 192.168.10.20 ou 192.168.20.0/24.
  3. Vérifiez les sources interrogées et choisissez « Enregistrer et appliquer ».
  4. Testez dans le navigateur d’un ordinateur du même réseau : http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000 renvoie le nom.
  5. Configurez le système téléphonique selon le guide et passez un appel de test. La requête apparaît sur l’accueil sous « Requêtes récentes ».
Boîte de dialogue « Ajouter une interface » : types de connexion classés par méthode technique, avec exemples et recherche.
Boîte de dialogue « Ajouter une interface » : en haut la méthode technique, en dessous des exemples ; la recherche trouve d’autres systèmes téléphoniques et téléphones.

Erreurs de connexion fréquentes

SymptômeCause et solution
Aucune entrée sous « Requêtes récentes », état « En attente de requêtes »La requête n’atteint pas CallerHub. Vérifiez l’adresse dans le système (IP, port, http/https), le pare-feu Windows et les pare-feu entre réseaux.
status=401Clé API fausse ou absente. Recopiez le guide ; une clé régénérée doit aussi être changée dans le système téléphonique.
status=403L’adresse de l’émetteur ne fait pas partie des IP autorisées. Derrière un NAT ou un proxy inverse, l’émetteur est différent.
status=429Trop de clés erronées depuis cette adresse. Attendez la fin du blocage (5 minutes par défaut).
La requête arrive mais sans nomNuméro inconnu, mauvais format pour le système, ou délai d’attente du système plus court que le temps de réponse.
HTTPS échoueLe système ne fait pas confiance au certificat ou le nom ne correspond pas. Importez le certificat racine dans le système.
Accents erronés ou nom tronquéLes réponses sont en UTF-8 ; vérifiez le jeu de caractères du système. Réglez la longueur maximale du nom sous Administration → Avancé.

Si la cause reste floue, « Dépannage → Démarrer l’enregistrement étendu … » enregistre chaque requête avec tous les en-têtes (clés masquées). Le simulateur intégré teste une configuration sans qu’un vrai système appelle.