STARFACE : nom de l’appelant depuis un CRM, un ERP ou SQL
Par lui-même, le STARFACE connaît les noms de ses propres carnets d’adresses. Si vos clients sont enregistrés dans un CRM, un ERP ou une base de données, le système téléphonique a besoin d’une recherche à chaque appel ou d’une synchronisation dans le carnet d’adresses. Cette page décrit les deux.
Comment le STARFACE obtient un nom
- Carnet d’adresses du système téléphonique : les contacts enregistrés dans un carnet d’adresses STARFACE s’affichent comme nom. S’ils y sont importés ou tenus à jour à la main, il faut maintenir à jour une seconde copie des données.
- Un module à chaque appel : le STARFACE n’a pas de recherche de nom intégrée via une adresse web. Un module de type Call-Processing peut appeler une adresse à chaque appel entrant et utiliser la réponse comme nom de l’appelant.
Pour le module, il vous faut un accès administrateur au STARFACE. Les modules s’importent sous Admin → Modules → Module library → Import module (guide STARFACE, en allemand). Un STARFACE dans le cloud doit pouvoir joindre le service interrogé depuis Internet ; le port est alors redirigé dans votre pare-feu vers cet ordinateur.
Avec CallerHub : un nom pour chaque appel entrant
CallerHub fournit un module prêt à l’emploi : le fichier CallerHub_Interface_….sfm du dossier Samples. Lors d’un appel entrant, le module demande le nom à CallerHub et affiche la réponse. Le guide a été testé avec STARFACE 10.0.2.6 (cloud).
- Dans CallerHub, choisissez STARFACE sous Interfaces → Ajouter une interface, saisissez un libellé et cliquez sur Créer. Sous Adresses IP autorisées, saisissez l’émetteur du STARFACE, cochez les sources de données interrogées et cliquez sur Enregistrer et appliquer.
- Dans le STARFACE, ouvrez Admin → Modules → Module library → Import module et choisissez le fichier du dossier
Samples. - Dans le Module manager, onglet Module configuration, créez une nouvelle configuration pour le module CallerHub. Dans
LOOKUP_URL, saisissez l’adresse de CallerHub, p. ex.https://callerhub.example.com:8080/lookup(terminée par/lookup, sans paramètres) ; dansAPI_KEY, la clé de l’interface. Enregistrez et activez la configuration. - Redirigez le port de CallerHub (8080 par défaut) dans le pare-feu vers l’ordinateur CallerHub.
- Appelez depuis un numéro enregistré dans le CRM. L’accès apparaît dans CallerHub sous Derniers accès.

« Copier les instructions » sur la carte fournit le même guide avec la vraie clé API. Les noms proviennent de toutes les sources de données sélectionnées pour cette interface, p. ex. une base de données SQL, un export DATEV ou Active Directory.
Appels sortants, application et client web : synchroniser le carnet d’adresses
Pour les appels sortants, l’application STARFACE, le client web et les listes d’appels n’affichent que les noms des carnets d’adresses STARFACE. Pour ces cas, CallerHub écrit les contacts de vos sources de données dans un carnet d’adresses distinct via l’interface REST de STARFACE : chaque nuit à l’heure réglée, après chaque rechargement des sources de données et d’un simple clic.
- Uniquement dans son propre carnet : CallerHub ne crée, ne modifie et ne supprime des contacts que là. Si une source est vide ou a diminué de plus de moitié, il ne supprime rien.
- Connexion depuis l’intérieur : CallerHub se connecte au système téléphonique ; aucune règle de pare-feu entrante n’est nécessaire pour cela. À partir de STARFACE 10 avec OAuth.
- Créer le carnet d’adresses : à partir de STARFACE 10, vous le créez sous Administration → Address book → Directory configuration avec accès en écriture, sous le même nom que dans CallerHub.
Analyse des appels et vue en direct
Saisissez aussi EVENT_URL dans le module : la même adresse, terminée par /event. Le module signale alors chaque événement d’un appel (sonnerie, décroché, raccroché, transfert) pour l’analyse des appels, les statistiques et la vue en direct. CallerHub a besoin pour cela du numéro de base du système téléphonique (p. ex. +49 40 66969) ; sinon, il ne peut reconnaître ni le sens de l’appel ni les appels internes.
Pour les appels antérieurs, utilisez l’export des données d’appel : Administration → Evaluation → Export call data, puis placez le fichier output.csv dans le dossier de l’interface.
Erreurs fréquentes
| Symptôme | Cause et solution |
|---|---|
Module Designer, onglet Log File : ConnectTimeoutException | Le STARFACE ne parvient pas à joindre CallerHub. Vérifiez l’adresse, la redirection de port et HTTPS. |
Journal : status=401 | La clé API dans la configuration du module est erronée. |
Journal : status=403 | L’adresse IP du STARFACE manque dans les adresses IP autorisées ; le journal l’indique sous la forme ip=…. |
Journal : status=404 | L’adresse ne se termine pas par /lookup. |
| Aucune requête lors des appels | Le module doit être de type Call-Processing et la configuration active. |
| Tous les appels apparaissent comme sortants | Saisissez le numéro de base du système téléphonique dans CallerHub. |
Le journal du module STARFACE peut contenir des identifiants. Vérifiez-le avant de le transmettre et supprimez-en les mots de passe.
Questions fréquentes
Dois-je développer moi-même le module STARFACE ?
Non. CallerHub fournit le module sous forme de fichier dans le dossier Samples ; vous l’importez et saisissez l’adresse et la clé API. Si l’import affiche « Licence required », le support vous aide.
Cela fonctionne-t-il avec STARFACE Cloud ?
Oui. Le guide a été testé avec STARFACE 10.0.2.6 dans le cloud. CallerHub a alors besoin d’une adresse joignable depuis Internet, et les adresses IP autorisées limitent les requêtes à l’émetteur de votre STARFACE.
Les données clients sont-elles copiées dans le STARFACE ?
Pas pour la recherche de nom : le module interroge CallerHub à chaque appel et CallerHub répond à partir de sa liste en mémoire. Seule la synchronisation facultative du carnet d’adresses écrit des contacts dans un carnet d’adresses STARFACE distinct.
Quelles sources de données le STARFACE peut-il interroger ainsi ?
Toutes les sources de données de CallerHub : SQL Server, Oracle, MySQL/MariaDB, PostgreSQL et autres bases ODBC, fichiers CSV comme l’export DATEV, API REST de systèmes CRM et ERP, LDAP/Active Directory, Microsoft 365 et Exchange. L’édition de base permet une source de données, l’édition complète jusqu’à dix.
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.