TelCheck propose deux outils pour les webmasters et développeurs souhaitant intégrer des données de réputation téléphonique dans leur site ou application : un widget iframe prêt à l'emploi et une API REST pour les intégrations plus avancées. Ce guide explique comment utiliser ces deux outils, leurs cas d'usage et les meilleures pratiques d'intégration.
Le widget iframe : intégration en une ligne
Le widget TelCheck s'intègre via une simple balise iframe pointant vers https://telcheck.fr/embed/{numéro} — remplacez {numéro} par le numéro en format national ou international. Exemple : <iframe src="https://telcheck.fr/embed/0612345678" width="320" height="200" frameborder="0"></iframe>. Le widget affiche le score de réputation, le badge de risque coloré et un résumé des principaux signalements de la communauté TelCheck. Il est responsive et s'adapte à la largeur disponible.
Cas d'usage du widget pour les webmasters
- Forums de consommateurs : intégrez le widget à côté des discussions sur un numéro suspect pour afficher sa réputation en temps réel.
- Sites d'annonces classées : affichez le score TelCheck à côté du numéro de contact d'un vendeur pour rassurer les acheteurs.
- Blogs et sites d'information : illustrez un article sur une arnaque avec le widget du numéro concerné.
- Outils internes d'entreprise : intégrez la vérification de réputation dans un outil de gestion des appels entrants ou un CRM.
L'API REST : intégration programmatique
Pour les intégrations plus avancées, TelCheck expose une API REST à l'adresse /api/phone/{numéro}. Cette API retourne un objet JSON contenant le score de réputation, la catégorie dominante, le nombre de signalements, la localisation du numéro et d'autres métadonnées. Elle est adaptée aux développeurs souhaitant intégrer la vérification de réputation dans leur application mobile, leur CRM ou leur système de téléphonie.
Paramètres et format de réponse de l'API
L'endpoint accepte le numéro au format national (0612345678) ou international (+33612345678). La réponse JSON inclut : le score (entier de 1 à 9), le label de risque (trustworthy / neutral / suspicious), le nombre de signalements, la catégorie principale et la localisation du numéro. Consultez la page API Docs de TelCheck pour les détails du schéma et les limites de débit.
Bonnes pratiques d'intégration
- Mise en cache : les données de réputation TelCheck évoluent lentement. Mettez en cache les réponses API pendant au moins 1 heure pour ne pas solliciter inutilement l'API.
- Gestion des erreurs : prévoyez un affichage de repli si l'API est temporairement indisponible — ne bloquez pas votre interface sur une erreur réseau.
- Transparence : indiquez à vos utilisateurs que les données proviennent de TelCheck et de la communauté TelCheck, à titre informatif.
- Attribution : un lien visible vers telcheck.fr à côté du widget contribue à faire grandir la communauté TelCheck et améliore la qualité des scores pour tous.
Limites d'utilisation
Le widget iframe est gratuit pour les usages non commerciaux et à faible volume. L'API /api/phone est soumise à des limites de débit pour les accès non authentifiés. Pour un usage commercial ou à fort volume, contactez TelCheck via la page de contact.