Version préliminaire · Cette aide est encore en construction et sera enrichie progressivement.
Configurer l’intégration search.ch
Identifier les appelants grâce à l’annuaire public suisse
Avec l’intégration search.ch, echo identifie aussi les appelants qui ne figurent dans aucun de vos propres systèmes : echo recherche le numéro dans l’annuaire public suisse de search.ch, qui contient des entrées pour les personnes, les entreprises et les autorités. L’entrée d’une personne apparaît dans echo comme une personne, celle d’une entreprise ou d’une autorité comme une entreprise – avec les numéros de téléphone, adresses e-mail, sites web et adresse publiés dans l’annuaire.
L’intégration est configurée une seule fois par un administrateur et s’applique à toute l’organisation. Vous avez besoin de votre propre clé API search.ch.
Bon à savoir :
- Suisse uniquement. search.ch répertorie des entrées suisses. Les appelants d’autres pays n’y sont pas trouvés.
- Entrées publiques uniquement. echo trouve ce que search.ch publie. Les personnes sans entrée dans l’annuaire ne sont pas trouvées.
- Mise à jour sous 24 heures. echo conserve les résultats de search.ch pendant 24 heures. Une entrée modifiée apparaît donc dans echo au plus tard après un jour.
- Votre propre clé. Les conditions d’utilisation et les éventuelles limites de la clé API sont fixées par search.ch.
Prérequis
- search.ch est ajouté sous Paramètres → Intégrations (voir Fonctionnement des intégrations).
- Vous êtes connecté à echo en tant qu’administrateur.
Configurer search.ch
Demander une clé API
Demandez une clé API à search.ch sur search.ch/tel/api/getkey.en.html (s’ouvre dans un nouvel onglet). Le lien figure aussi sur la page de paramètres dans echo.
Saisir la clé
Ouvrez Paramètres → search.ch et collez la clé dans 1 Clé API. echo vérifie immédiatement la clé par une requête de test auprès de search.ch et affiche 2 La clé API est valide ou La clé API est invalide.
Enregistrer
Cliquez sur 3 Enregistrer. Le bouton n’est actif qu’une fois la clé confirmée comme valide. echo enregistre la clé de manière chiffrée ; ensuite, le champ affiche un espace réservé à la place de la clé.
Dès lors, echo inclut search.ch dans chaque identification d’appelant et chaque recherche de contact.
Modifier ou supprimer la clé
Pour remplacer la clé, cliquez dans Clé API, saisissez la nouvelle clé, attendez La clé API est valide et cliquez sur Enregistrer. Si vous quittez le champ sans rien saisir, la clé enregistrée reste inchangée.
Pour ne plus utiliser search.ch, retirez l’intégration en bas de la page sous Retirer l’intégration (voir Fonctionnement des intégrations).
Dépannage
La page indique que search.ch n’est pas activé. Ajoutez d’abord search.ch sous Paramètres → Intégrations.
Les paramètres search.ch n’apparaissent pas. Les paramètres des intégrations ne sont affichés qu’aux administrateurs ; adressez-vous à l’un d’eux.
« La clé API est invalide ». Vérifiez que vous avez copié la clé entière, sans espaces. Si elle est toujours refusée, demandez une nouvelle clé à search.ch.
L’intégration affiche Non configurée. Aucune clé API n’a encore été enregistrée. D’ici là, echo ne recherche pas dans search.ch.
Les appelants ne sont soudain plus reconnus du tout. Si search.ch refuse la clé enregistrée (par exemple parce qu’elle a été révoquée), toute l’identification des appelants peut échouer. Saisissez une clé valide ou retirez l’intégration.
Un appelant suisse n’est pas trouvé. Vérifiez sur search.ch si le numéro a une entrée publique. Les entrées modifiées au cours des dernières 24 heures ne sont peut-être pas encore visibles dans echo.