Notre intégration Webhooks vous permet d'envoyer des données Livestorm via des webhooks aux URL de votre choix .
De nombreux scénarios d’automatisation peuvent être réalisés, comme l’ajout de nouveaux inscrits à une feuille Google, l’envoi d’une notification Slack après la fin d’un événement, l’envoi de la rediffusion d’un événement aux personnes qui n’ont pas pu y assister, et plus encore! La liste est interminable.
Livestorm est livré avec un intégation webhooks , qui vous permet d’envoyer vos données d’enregistrement et d’événement à n’importe quelle URL de votre choix.
Notre API REST fournit également un moyen de gérer les webhooks, qui sont légèrement plus avancés (nouveaux déclencheurs et charges utiles étendues). N’hésitez pas à les consulter dans notre developers hub !
DANS CET ARTICLE
Ajouter un Webhook
- 1
- Allez dans le menu de vosParamètres , puis dans Paramètres du compte.
- 2
- Cliquez sur Intégrations et sélectionnez la carte Webhooks.
- 3
- Cliquez sur Configurer l'intégration puis sur Ajouter un webhook.
- 4
- Choisissez le déclencheur et copiez l'URL de votre choix.
- 5
- Et cliquez sur Ajouter un webhook.
- 6
- Vous pouvez modifier vos webhooks et les supprimer .
Contrairement à nos autres intégrations natives, l'intégration des Webhooks s'appliquera à tous vos événements. Vous n'aurez donc pas à activer cette intégration pour un événement en particulier. Vous pouvez filtrer et choisir le type de données que vous souhaitez conserver via votre propre système une fois que vous les recevez.
Les 6 déclencheurs que nous fournissons
Nous fournissons les déclencheurs 6 suivants :
- Création d'un événement : lorsqu’un nouvel événement est créé
- Session créée : lorsqu’une session est planifiée
- Publication d'un événement : lorsqu’un événement est publié
- Nouvel inscrit : lorsqu’une personne s’inscrit à une session d’événement
- Démarrage d'un événement : au démarrage d’une session d’événement
- Fin d'un événement : à la fin d’une session d’événement
Voici quelques exemples du JSON que nous envoyons pour ces 6 déclencheurs :
Création d'un événement
{ "data": { "id": "29e88fxb-7370-47ce-9589-a691c7l272of", "type": "events", "attributes": { "title": "New event webhook", "slug": "new-event-webhook", "registration_link": "https://app.livestorm.co/p/79e88fxb-6370-47ce-9589-a691c7l272of", "estimated_duration": 30, "registration_page_enabled": true, "everyone_can_speak": false, "description": null, "status": "draft", "light_registration_page_enabled": true, "recording_enabled": true, "recording_public": true, "show_in_company_page": false, "chat_enabled": true, "polls_enabled": true, "questions_enabled": true, "language": "en", "published_at": 0, "scheduling_status": "draft", "created_at": 1643710217, "updated_at": 1643710219, "owner": { "id": "a850c828-b9a0-416d-ae13-8b672bch11e2", "type": "people", "attributes": { "role": "team_member", "created_at": 1599990459, "updated_at": 1643710219, "timezone": "Europe/Paris", "first_name": "James", "last_name": "Doe", "email": "james.doe@livestorm.co", "avatar_link": null } }, "sessions_count": 1, "fields": [{ "id": "email", "type": "text", "order": 0, "required": true }, { "id": "first_name", "type": "text", "order": 1, "required": true }, { "id": "last_name", "type": "text", "order": 2, "required": true }] }, "meta": { "webhook": { "id": "b836c804-8696-4946-a8c8-ece61da0ecd6", "event": "event.created" } } } }
Session créée
{ "data": { "id": "1e9d9b14-f990-4e19-a436-9a7dd6a5780a", "type": "sessions", "attributes": { "event_id": "71cfa73b-6fbe-4f55-b219-28f4b195ae94", "status": "draft", "timezone": "Europe/Paris", "room_link": "https://app.livestorm.co/p/71cfa73b-6fbe-4f55-b219-28f4b195ae94/live?s=1e9d9b14-f990-4e19-a436-9a7dd6a5780a", "attendees_count": 0, "duration": null, "estimated_started_at": 1645459200, "started_at": 0, "ended_at": 0, "canceled_at": 0, "created_at": 1644845096, "updated_at": 1644845096, "registrants_count": 1, "breakout_room_parent_session_id": null }, "meta": { "webhook": { "id": "86c06b1c-440e-4693-90bc-f68ba21036f3", "event": "session.created" } } } }
Publication d'un événement
{ "webinar": { "identify": "a695b8cb-8467-4a95-b259-75b622bd91b0", "title": "Product demo", "slug": "product-demo", "created_at": "2021-05-18T08:43:25.304Z", "estimated_duration": 1800, "registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0", "published_at": "2021-05-18T08:43:31.433Z", "nb_registered": null } }
Nouvel inscrit
{ "attendee": { "identify": "13q82e6b-c6a2-497d-acfd-0cb2d00b6636", "created_at": "2021-03-12T09:26:43.700Z", "first_name": "John", "last_name": "Doe", "email": "john@doe.com", "avatar_link": null, "referrer": null, "utm_source": null, "utm_medium": null, "utm_term": null, "utm_content": null, "utm_campaign": null, "browser_version": "90.0.4430.93", "browser_name": "Chrome", "os_name": "Macintosh", "os_version": "10.15.7", "screen_height": "900", "screen_width": "1440", "ip_city": "Paris", "ip_country_code": "FR", "ip_country_name": "France", "password_key": "w68d21e717ae84ec4915d4", "fields": {}, "connection_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?email=john%40doe.com&key=w68d21e717ae84ec4915d4" }, "webinar": { "identify": "a695w8cb-8467-4a95-b259-75b622bd91b0", "title": "Product demo", "slug": "product-demo", "created_at": "2021-05-18T08:43:25.304Z", "estimated_duration": 1800, "registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0", "published_at": "2021-05-18T08:43:31.433Z", "nb_registered": 2, "room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=fqa1475e-fe2d-4egd-a007-6c27364bfeba", "estimated_started_at": "2021-05-18T10:00:00.000Z" } }
Démarrage d'un événement
{ "webinar": { "identify": "a695b8cb-8467-4a95-b259-75b622bd91b0", "title": "Product demo", "slug": "product-demo", "created_at": "2021-05-18T08:43:25.304Z", "estimated_duration": 1800, "registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0", "published_at": "2021-05-18T08:43:31.433Z", "nb_registered": 2, "room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=w0a1475e-fe2d-4wad-a007-6c27364bfeba", "estimated_started_at": "2021-05-18T10:00:00.000Z", "started_at": "2021-05-18T08:46:33.377Z" } }
Fin d'un événement
{ "webinar": { "identify": "a695b8cb-8467-4a95-b259-75b622bd91b0", "title": "Product demo", "slug": "product-demo", "created_at": "2021-05-18T08:43:25.304Z", "estimated_duration": 1800, "registration_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0", "published_at": "2021-05-18T08:43:31.433Z", "nb_registered": 2, "room_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?s=w0a1475e-fe2d-4wad-a007-6c27364bfeba", "estimated_started_at": "2021-05-18T10:00:00.000Z", "started_at": "2021-05-18T08:46:33.377Z", "ended_at": "2021-05-18T08:48:04.528Z", "duration": 91, "nb_attended": 1, "attendees": [ { "identify": "13982e6b-c6a2-497d-acfd-0cb2d00b6636", "created_at": "2021-03-12T09:26:43.700Z", "first_name": "John", "last_name": "Doe", "email": "john@doe.com", "avatar_link": null, "referrer": null, "utm_source": null, "utm_medium": null, "utm_term": null, "utm_content": null, "utm_campaign": null, "browser_version": "90.0.4430.93", "browser_name": "Chrome", "os_name": "Macintosh", "os_version": "10.15.7", "screen_height": "900", "screen_width": "1440", "ip_city": "Paris", "ip_country_code": "FR", "ip_country_name": "France", "password_key": "e68s21e717be84ec4915d4", "fields": {}, "connection_link": "https://app.livestorm.co/p/a695b8cb-8467-4a95-b259-75b622bd91b0/live?email=pierre%2Bregistrant1%40livestorm.co&key=e68s21e717be84ec4915d4", "is_attendance": true, "attendance_rate": 100, "attendance_duration": 181, "messages_count": 0, "questions_count": 0, "votes_count": 0, "up_votes_count": 0 } ] } }