Passer au contenu principal

API et Webhooks

Comment accéder, configurer et utiliser notre API et nos Webhooks

Mis à jour cette semaine

Vous savez déjà que tl;dv est synonyme de gain de temps et de rationalisation du travail. L'utilisation de notre API publique et de nos webhooks simplifiera encore plus les choses.

Voici comment y accéder, les configurer et décharger encore plus de travail !

API publique

Notre API vous permet d'importer des réunions et de créer des flux de travail personnalisés adaptés à vos besoins. L'accès à l'API et aux webhooks est uniquement disponible avec l'abonnement Business.

  • Formule Business : accès API inclus

  • Formules Pro ou Gratuite : accès API non inclus ni disponible

Comment utiliser l'API publique de tl;dv

Pour commencer, vous aurez besoin de :

  1. Votre clé API : vous la trouverez dans vos paramètres de compte si vous avez souscrit à la formule Business.

  2. Configuration technique : la mise en œuvre nécessite généralement un peu de codage, donc un développeur de votre équipe peut avoir besoin de vous aider.

Elle contient tout ce dont vous avez besoin pour commencer l'intégration.

Besoin d'aide ou souhaitez effectuer une mise à niveau ?

Si vous n'êtes pas sûr d'avoir accès ou de savoir comment l'utiliser, nous sommes là pour répondre à vos questions ou vous aider à passer à la formule Business. Contactez support@tldv.io - nous nous ferons un plaisir de vous aider ! 🙌


Webhooks

Comment configurer les webhooks pour recevoir les données des réunions

Vous souhaitez automatiser les flux de travail en recevant les données des réunions en temps réel ? Nous pouvons configurer un webhook pour vous ! Une fois configuré, nous vous enverrons une charge utile dès qu'une réunion (ou sa transcription) sera prête, sans avoir besoin d'interroger notre API.

Comment ça marche

Les webhooks vous permettent de recevoir une notification lorsque :

  • Une réunion est traitée avec succès (MeetingReady)

  • Une transcription est disponible (TranscriptReady)

Chaque webhook comprend des métadonnées riches, idéales si vous créez des automatisations ou des intégrations personnalisées, et chaque événement envoie une charge utile JSON qui correspond au format utilisé dans notre API publique.

Voici à quoi cela ressemble :

{  "id": "webhook-job-id",  "event": "MeetingReady",  "executedAt": "2025-06-16T09:23:00Z",  "data": {    "id": "meeting-id",    "happenedAt": "2025-06-15T14:00:00Z",    "name": "Team Sync",    "organizer": {      "email": "organizer@example.com",      "name": "Alex Taylor"    },    "invitees": [      {        "email": "teammate@example.com",        "name": "Jordan Lee"      }    ],    "url": "https://app.tldv.io/meetings/meeting-id"  }}

Une fois activé, nous déclencherons le webhook chaque fois que vous organiserez une réunion et qu'elle sera traitée avec succès. Si les transcriptions sont régénérées ultérieurement, vous recevrez également un événement TranscriptReady supplémentaire.

Ce dont nous avons besoin de votre part

Puisque vous ne pouvez pas configurer les webhooks de votre côté, envoyez-nous simplement les informations suivantes afin que nous puissions les configurer pour vous :

  1. URL du webhook : le point de terminaison auquel vous souhaitez que nous envoyions les données.

  2. E-mail de l'utilisateur : l'adresse e-mail de l'utilisateur auquel le webhook doit être lié.

  3. Configuration d'en-tête facultative : toute configuration ou en-tête supplémentaire (par exemple, les jetons d'authentification) que vous souhaitez que nous incluions dans la requête.

Envoyez-nous ces informations par chat ou par e-mail, et nous nous occuperons du reste. 🔮

Avez-vous trouvé la réponse à votre question ?