Les communications professionnelles, tout simplement
Applications mobiles et de bureauDéveloppeursÉtat des services IllyVoIPCentre d’aide
Toutes les fonctionnalités

Webhooks

Un événement de service. Une action dans vos outils.

Reliez les événements d’appel, de SMS, de contact et de messagerie vocale à votre application grâce à des données documentées, des requêtes signées et un historique de livraison.

Lire la documentation des webhooksDécouvrir le fonctionnement

Les événements qui
font avancer vos processus.

Choisissez une catégorie pour consulter les événements actuellement documentés. Il s’agit d’une référence, pas d’un flux en direct.

call_initiated

Un appel commence.

call_ringing

Un appel entre dans la phase de sonnerie.

call_answered

Un appel est décroché.

call_completed

Un appel se termine ; sa durée finale est incluse.

Comment ça marche

Un événement se produit.
Votre application réagit.

IllyVoIP envoie des requêtes POST en JSON à l’URL de réception que vous configurez.

Choisissez vos abonnements

Créez un point de réception dans les paramètres Webhooks du compte. Abonnez-vous aux événements d’appel, de SMS, de contact ou de messagerie vocale utiles à votre application.

Vérifiez avant de traiter

Contrôlez l’en-tête Illyvoip-Signature à l’aide du secret du webhook, de l’horodatage et du corps brut de la requête, conformément à la documentation.

Accusez réception et mettez en file

Renvoyez rapidement une réponse 2xx réussie. Placez les traitements longs dans une file pour ne pas retarder l’accusé de réception.

Gérez les livraisons répétées

Conservez l’identifiant de l’événement contenu dans le corps et ignorez les événements déjà traités. Une nouvelle tentative peut livrer le même événement.

Prévoyez les conditions
réelles de livraison.

Le portail propose un historique des livraisons ; la documentation API décrit les données, les signatures et les nouvelles tentatives.

Examinez les échecs
Consultez le statut de livraison, la réponse HTTP et l’erreur pour distinguer un problème du récepteur d’un problème de logique métier.
Séparez les environnements SMS
Un point de réception peut recevoir les événements de tous les identifiants d’expéditeur ou seulement de certains. Chaque point correspondant reçoit l’événement ; modifier les filtres ne rejoue pas les anciens événements.
Gardez les secrets sur votre serveur
La gestion des webhooks couvre les points de réception, les secrets et les journaux de livraison de tout le compte. Accordez cette autorisation en connaissance de cause. Lire la spécification actuelle des webhooks

Quelques précisions
utiles.

Contacter notre équipe
Existe-t-il un webhook pour chaque action du portail ?+

Non. Consultez le catalogue d’événements de l’API. Abonnez-vous uniquement aux événements disponibles pour le parcours souhaité.

Un même événement peut-il arriver plusieurs fois ?+

Oui. Les nouvelles tentatives conservent le même identifiant d’événement. Dédupliquez avec le champ id du corps, et non avec l’identifiant de la tâche de livraison.

Quels échecs donnent lieu à une nouvelle tentative ?+

La documentation actuelle prévoit de réessayer après une erreur réseau ou une réponse HTTP 408, 429 ou 5xx. Les redirections et les autres réponses 4xx interrompent la livraison. Consultez la dernière spécification avant de développer votre récepteur.

Faites avancer vos processus grâce aux événements.

Commencez par la documentation actuelle, puis configurez votre point de réception.

Lire la documentation des webhooksÉchanger avec notre équipe