Interface et réseau
Ce dont les administrateurs ont besoin pour la mise en place. Les exemples utilisent 192.168.10.5 comme serveur CallerHub, le port 8080 et l’espace réservé API-KEY.
URL de recherche pour le système téléphonique
Le système téléphonique appelle cette adresse à chaque appel et reçoit le nom en retour. Chaque interface a sa propre clé API ; CallerHub répond avec les sources de données de cette interface.
http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000
→ Becker & Partner - Laura Becker (vide si inconnu)
L’adresse adaptée à chaque système figure sur la page téléphonie ; « Copier le guide » dans CallerHub la fournit avec la vraie clé API. Au lieu du paramètre apikey, la clé peut aussi être envoyée dans l’en-tête X-Api-Key ; elle n’apparaît alors pas dans les journaux du proxy.
Codes de réponse
| Code | Signification |
|---|---|
200 | Nom trouvé (vide pour un numéro inconnu) |
401 | Clé API ou d’accès erronée ou absente |
403 | Adresse IP non autorisée pour cette interface |
404 | chemin inconnu ou module désactivé |
405 | mauvaise méthode HTTP |
429 | bloqué temporairement après trop de clés erronées |
503 | aucune source prête ou liste de numéros pas encore chargée |
Plus d’aide pour le dépannage : erreurs de connexion fréquentes.
Connexions réseau et ports
CallerHub n’établit que les connexions que vous configurez. Il n’envoie aucune donnée d’appel ni personnelle à l’éditeur ; il ne se connecte à callerhub.de que pour la recherche de mises à jour et, avec sa propre clé de licence ou un essai, pour la liste de révocation et la vérification en ligne de la licence.
| Connexion | Sens | Port (exemple) | Contenu | Quand |
|---|---|---|---|---|
| Système téléphonique → CallerHub | entrant | 8080 HTTP / 8443 HTTPS | Numéro, éventuellement numéro appelé et utilisateur, clé API → nom, éventuellement lien | à chaque appel |
| CallerHub → base SQL | sortant | 1433, 1521, 3306, 5432 | Connexion, SELECT | liste à intervalle ou à chaque appel |
| CallerHub → LDAP/AD | sortant | 389 / 636 | Connexion, recherche | à intervalle |
| CallerHub → Microsoft 365, EWS, REST | sortant | 443 | Demande de jeton, récupération des contacts | à intervalle ou à chaque appel |
| CallerHub → SMTP / webhook | sortant | 587 / 465 / 25, 443 | Panne et rétablissement, rapports ; sans numéros | en cas de panne ou selon planning |
| Navigateur / supervision → CallerHub | entrant | comme l’interface | Statistiques, analyse des appels, supervision avec clé d’accès | à l’accès |
| Téléphones → annuaire LDAP | entrant | 389 / 636 | Recherche par nom et inverse | à chaque recherche |
| Réception en direct des journaux d’appels | entrant ou sortant | 5100, 5101, 5038, 1080, 1012 ou 443 | Journal par appel | en continu ou à intervalle |
| CallerHub → callerhub.de | sortant | 443 | Demande de la dernière version, téléchargement du programme ; avec sa propre clé de licence, la liste signée de révocation des licences | lors de « Rechercher des mises à jour » ou d’une mise à jour ; liste de révocation une fois par jour |
| CallerHub → STARFACE (REST) | sortant | 443 | Contacts vers son propre carnet STARFACE | la nuit, après rechargement, à la demande |
| Téléphones Mitel → CallerHub | entrant | HTTP, TFTP | Fichiers de configuration, pages d’écran | au démarrage du téléphone, à la demande |
| CallerHub → nuget.org | sortant | 443 | Téléchargement du pilote Oracle | uniquement si le pilote manque et que vous confirmez |
| Découverte réseau | sortant | notamment 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900 | Tentative de connexion sans authentification | uniquement après lancement explicite |
Autres interfaces
- Accès navigateur : statistiques et analyse des appels dans le navigateur, redirection vers la fiche CRM pour les pop-ups CTI – avec sa propre clé d’accès.
- Supervision : Nagios, Icinga, Checkmk, PRTG, Zabbix, Prometheus et Grafana – avec sa propre clé de supervision.
- Journaux et événements d’appels des systèmes téléphoniques et de vos propres scripts.
- Plugins : vos propres extensions, exécutées à chaque appel.
Les détails techniques de ces interfaces (points d’accès et paramètres, commandes console, interface des plugins et des événements) sont disponibles sur demande auprès du support : info@callerhub.de.