Connectez Rinkel à votre CRM, votre helpdesk, Slack ou un outil sur mesure. Avec l'API et les webhooks de Rinkel, vos données d'appel arrivent exactement là où vous en avez besoin — et vous automatisez une grande partie du travail manuel.
Bon à savoir ❗ L'API et les webhooks sont disponibles avec les abonnements Professional et Expert (les webhooks étaient auparavant réservés à Expert — désormais disponibles également avec Professional). C'est un travail technique : un développeur ou un responsable informatique s'en charge rapidement, mais vous pouvez aussi le configurer vous-même si vous y consacrez un peu de temps.
Toute la documentation technique se trouve sur developers.rinkel.com (en anglais). Besoin d'inspiration ? Consultez la page des intégrations pour des exemples concrets.
Qu'est-ce qu'une clé API et à quoi sert-elle ?
Une clé API est un code unique — semblable à un mot de passe — qui permet à votre système d'accéder aux données de votre compte Rinkel. Sans clé, pas d'accès.
Vous créez une clé API dans MyRinkel (ici).
Attention ❗ Traitez votre clé API comme un mot de passe. Ne la partagez pas publiquement et ne l'intégrez pas dans du code que vous publiez sur un dépôt public.
Démarrer avec l'API Rinkel
L'API fonctionne en REST et vous trouverez tous les endpoints, paramètres et exemples sur developers.rinkel.com.
Travailler avec les webhooks
Un webhook envoie automatiquement un message à votre système dès qu'un événement se produit dans Rinkel. Par exemple : un appel entrant arrive ? Ouvrez un ticket. Appel terminé ? Mettez à jour la fiche client dans votre CRM.
Configurer un webhook
Rendez-vous sur cette page dans MyRinkel.
Choisissez le webhook à configurer et saisissez l'URL de votre endpoint (il doit pouvoir recevoir des requêtes POST).
Quels événements pouvez-vous utiliser ?
Appel entrant — un appel arrive (pas encore décroché). Envoie id, datetime, to et from.
Appel sortant — vous appelez vers l'extérieur (pas encore décroché). Mêmes champs que ci-dessus.
Début d'appel — l'appel a été décroché. Envoie id, datetime, answeredBy et l'option du menu vocal choisie, le cas échéant.
Fin d'appel — l'appel est terminé. Envoie id, datetime et cause (six raisons possibles : sans réponse, décroché, bloqué, messagerie vocale, file d'attente, hors des heures d'ouverture).
Vous avez AI Insights ? Vous pouvez également utiliser l'événement Call insights pour envoyer le résumé, le sentiment et les sujets vers votre propre système. Reliez-le à un appel via le même id.
Les champs exacts du payload sont disponibles sur developers.rinkel.com.
Sécurité
Tout le trafic webhook passe par HTTPS et le payload est en JSON. De votre côté, n'acceptez que les requêtes provenant du domaine Rinkel.
Votre webhook ne fonctionne pas ?
Vérifiez les points suivants :
L'URL de votre endpoint est-elle correcte et accessible depuis internet ?
Votre endpoint accepte-t-il les requêtes POST ?
Votre application renvoie-t-elle un 200 OK à la réception ?
Autorisez-vous les requêtes provenant du domaine Rinkel ?
Toujours bloqué ? Envoyez-nous le message d'erreur à [email protected] — on s'occupe du reste.
Questions fréquentes
Sur quels abonnements puis-je utiliser l'API et les webhooks ?
Professional et Expert.
Puis-je transmettre AI Insights à mon CRM ?
Oui, via l'événement webhook Call insights. Reliez-le aux autres événements webhook avec le même id d'appel si vous avez également besoin des numéros de téléphone.
Je veux voir le nom de l'appelant en direct dans mon CRM lors d'un appel entrant — c'est possible ?
Oui. Utilisez le webhook d'appel entrant pour envoyer les données directement à votre CRM dès l'arrivée de l'appel.
Rinkel fonctionne-t-il avec Zapier, Make ou Integrately ?
L'intégration directe avec Zapier a été arrêtée. Grâce aux webhooks, vous connectez Rinkel vous-même à toute plateforme qui reçoit des webhooks — Zapier, Make et Integrately fonctionnent très bien.