Aller au contenu

Ringfully s’appelle maintenant Inbound CX Nouveautés

Parler aux ventesDemander une démo
Demander une démo
Menu
Parler aux ventesDemander une démo

Tapez un mot ou deux. Échap pour fermer.

Cours

Relier vos systèmes : API et webhooks

Reliez vos propres logiciels : des clés d’API pour les fiches d’appels, les contacts et les messages, des webhooks signés quand quelque chose se passe, et des étapes de menu qui consultent vos données sur l’appelant.

  • 3 leçons
  • Environ 3 min de lecture
  • Pour la personne qui relie d’autres logiciels

Rédigé par John, Propriétaire et chef de la direction. Revu le 15 septembre 2026.

Les noms d’écrans et de boutons sont cités tels que le portail les affiche, en anglais.

Leçon 1

Les clés d’API

1 min de lecture

À la fin, vous saurez

  • Créer une clé d’API et la garder en lieu sûr.
  • Savoir ce que l’API peut lire et modifier.
  • Savoir quels forfaits l’incluent.

Étapes

  1. L’API fait partie des forfaits Pro et Business. Ouvrez « Settings », puis « API Keys », et appuyez sur « New API key ».
  2. Nommez la clé d’après le système qui la gardera, et choisissez sa date d’expiration. Une entreprise peut avoir jusqu’à 10 clés actives.
  3. Copiez la clé quand elle s’affiche, gardez-la dans le coffre à secrets de ce système, et envoyez-la comme jeton porteur (bearer).
  4. Une clé créée dans le portail peut lire les fiches d’appels, lire et modifier les contacts, et lire et envoyer des textos.

L’API couvre les fiches d’appels, les contacts et les messages, et rien d’autre : pas de contrôle des appels en cours, pas d’enregistrements, pas de boîte vocale, et rien qui modifie les réglages du compte.

Pour aller plus loin

Vérifiez ce que vous avez appris

Vos réponses sont vérifiées dans votre navigateur. Rien n’est enregistré ni envoyé.

  1. Laquelle de ces actions l’API peut-elle faire ?
  2. Une entreprise au forfait Starter peut-elle créer des clés d’API ?

Voir les réponses
  1. Envoyer un texto On peut lire et envoyer des messages; les appels en cours et les enregistrements sont hors de l’API.
  2. Non, l’API fait partie de Pro et Business L’accès à l’API fait partie des forfaits Pro et Business.

Leçon 2

Les webhooks

1 min de lecture

À la fin, vous saurez

  • Ajouter un point de réception de webhooks.
  • Vérifier qu’une livraison vient bien de votre compte.
  • Comprendre pourquoi une livraison n’est pas arrivée.

Étapes

  1. Ouvrez « Settings », puis « Webhooks », et appuyez sur « Add webhook endpoint ». L’adresse doit utiliser HTTPS, et son hôte doit déjà figurer sur la liste des adresses sortantes approuvées de votre entreprise.
  2. Trois événements sont envoyés : call.completed quand un appel se termine, voicemail.received quand un message vocal arrive, et sms.received quand un texto arrive.
  3. Chaque livraison est signée. Calculez un HMAC-SHA256 de l’en-tête x-inboundcx-timestamp, d’un point et du corps brut, avec votre secret de signature, et comparez-le à l’en-tête x-inboundcx-signature.
  4. Une livraison qui échoue est retentée, jusqu’à 8 tentatives sur un peu plus de deux heures. « Recent deliveries » montre ce qui s’est passé.

Vérifiez avec le corps exactement tel qu’il est arrivé. Un JSON analysé puis réécrit ne correspondra pas à la signature.

Pour aller plus loin

Vérifiez ce que vous avez appris

Vos réponses sont vérifiées dans votre navigateur. Rien n’est enregistré ni envoyé.

  1. Lequel de ces éléments est un événement de webhook ?
  2. Sur quoi porte la signature ?

Voir les réponses
  1. sms.received Les trois événements sont call.completed, voicemail.received et sms.received.
  2. L’horodatage et le corps brut Signer l’horodatage avec le corps permet de refuser une vieille livraison rejouée plus tard.

Leçon 3

Consulter vos données pendant un appel

1 min de lecture

À la fin, vous saurez

  • Approuver les adresses qu’un menu peut joindre.
  • Consulter votre propre système sur l’appelant avant qu’il joigne une personne.
  • Utiliser une table de données quand vous n’avez aucun système à interroger.

Étapes

  1. Ajoutez l’hôte de votre système à la liste des adresses sortantes approuvées de votre entreprise. Les menus et les webhooks ne joignent que des adresses https approuvées.
  2. Dans un menu, ajoutez API / HTTP request pour interroger votre système sur l’appelant, ou Look up in a table pour une liste que vous tenez dans « Flow Resources », onglet « Data tables ».
  3. Aiguillez selon la réponse avec Condition / branch, par exemple pour envoyer un client connu à l’équipe qui s’occupe de lui.
  4. Partez du modèle Look the caller up first pour voir le montage complet.

Une requête lancée par un menu abandonne après 5 secondes : prévoyez ce que l’appelant entend quand votre système est lent.

Pour aller plus loin

Vérifiez ce que vous avez appris

Vos réponses sont vérifiées dans votre navigateur. Rien n’est enregistré ni envoyé.

  1. Votre menu doit joindre https://orders.example.com. Que faites-vous d’abord ?
  2. Vous n’avez aucun système à interroger, seulement une liste de numéros prioritaires. Quelle étape convient ?

Voir les réponses
  1. Ajouter son hôte à la liste des adresses sortantes approuvées Tout ce qui n’est pas sur la liste est refusé.
  2. Look up in a table Une table de données dans « Flow Resources » contient la liste, et l’étape la lit pendant l’appel.

C’était le dernier cours

Tous les cours, et les parcours de lecture tirés des guides, sont sur la page Université.

Tous les cours

Prêt à répondre à chaque appel ?

Découvrez comment Inbound CX prend et achemine vos appels, en une démonstration de 15 minutes.

Réserver une démo