Comment utiliser les webhooks dans Talkizy ?

👉 À quoi servent les webhooks ?

Un webhook permet à Talkizy d'envoyer automatiquement des informations vers une URL externe lorsqu'un évènement précis se produit.
Vous pouvez ainsi utiliser les données envoyées par Talkizy pour déclencher des automatisations dans vos propres outils.

Talkizy propose deux évènements déclencheurs :

• Début de l'évènement (visio ou webinaire) : event.start
• Fin de l'évènement (visio ou webinaire) : event.end

👉 Où configurer les webhooks ?

Les webhooks se configurent directement depuis votre visio ou votre webinaire, une fois celui-ci créé.

Pour les paramétrer :

1. Rendez-vous dans le menu Évènements.
2. Ouvrez la visio ou le webinaire à venir concerné.
3. Rendez-vous dans Paramètres.
4. Ouvrez l'onglet Intégration.
5. Sous l'URL de redirection, vous retrouverez la section dédiée aux Webhooks.

Vous pourrez alors renseigner l'URL vers laquelle Talkizy doit envoyer les données.

👉 Quelles données sont envoyées au début de l'évènement ?

Lorsque votre visio ou votre webinaire démarre, le webhook event.start est déclenché.

Les données suivantes sont envoyées :

• event : type d'évènement déclenché, ici event.start.
• timestamp : date et heure d'envoi du webhook au format ISO 8601.
• meeting_id : identifiant de l'évènement.
• title : titre de l'évènement.
• creator : créateur de l'évènement.
• primary_host : animateur principal. Si aucun animateur principal n'est défini, le créateur de l'évènement est utilisé.
• created_at : date et heure de création de l'évènement.
• started_at : date et heure de début de l'évènement.
• nb_expected_participants : nombre de participants attendus, hors participants invités ayant le statut guest.

👉 Quelles données sont envoyées à la fin de l'évènement ?

Lorsque votre visio ou votre webinaire se termine, le webhook event.end est déclenché.

Il contient notamment les informations suivantes :

• event : type d'évènement déclenché, ici event.end.
• timestamp : date et heure d'envoi du webhook.
• meeting_id : identifiant de l'évènement.
• title : titre de l'évènement.
• creator : créateur de l'évènement.
• primary_host : animateur principal.
• created_at : date et heure de création de l'évènement.
• started_at : date et heure de début de l'évènement.
• ended_at : date et heure de fin de l'évènement.
• duration_in_seconds : durée de l'évènement en secondes.
• nb_expected_participants : nombre de participants attendus, hors invités ayant le statut guest.
• nb_real_participants : nombre de participants réellement présents.
• participants : détail des participants concernés par l'évènement, hors guest.

👉 Quelles informations sont disponibles pour chaque participant ?

Dans le webhook de fin, le champ participants permet de récupérer différentes informations pour chaque participant :

• name : nom et prénom du participant.
• email : adresse email du participant.
• role : rôle du participant, par exemple animator, co_host ou participant.
• present : indique si le participant était présent.
• arrived_at : date et heure auxquelles le participant a rejoint l'évènement. La valeur est null s'il était absent.
• left_at : date et heure auxquelles le participant a quitté l'évènement. La valeur peut être null si aucune heure de départ n'est disponible.
• presence_duration_seconds : durée de présence réelle du participant, en secondes. La valeur peut être null si cette durée ne peut pas être déterminée.

💡 Le webhook de fin vous permet ainsi de récupérer des informations liées à la présence des participants afin de les exploiter dans vos propres systèmes.

🚨 La mise en place d'un webhook nécessite de disposer d'une URL capable de recevoir et de traiter les données envoyées par Talkizy.

Rendez-vous dès à présent sur Talkizy pour créer vos évènements ! 🤩

#webhook #automatisation #integration #visio #webinaire #participants #donnees

Mis à jour le : 05/10/2026