> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://aide.talkizy.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Comment utiliser les webhooks dans Talkizy ?

| Vous souhaitez connecter Talkizy à un outil externe ou automatiser certaines actions au début ou à la fin de vos évènements ? Les webhooks permettent d'envoyer automatiquement des données lorsqu'une visio ou un webinaire démarre ou se termine.

### 👉 À 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.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/7/6/d/876dc34ec71d1000/image_u5vlp.png)

### 👉 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](https://app.talkizy.fr/inscription) pour créer vos évènements ! 🤩

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