Réunions et transcriptions

Une réunion est un enregistrement ou un import dans Meetingize : ses métadonnées, la transcription diarisée, le compte rendu IA (appelé summary dans l’API) et les documents générés à partir de celle-ci. Les réunions sont identifiées par un UUID.

Pour créer une réunion à partir d’un enregistrement, voir Créer une réunion et récupérer les résultats.

Comment lister ou rechercher des réunions ?

GET /v1/meetings renvoie vos réunions, les plus récentes en premier, avec filtres optionnels.

GET /v1/meetings?q=budget&client=Dupont&tag=rdv&recorded_after=2026-07-01T00:00:00Z&status=completed&limit=20

Paramètre	Description
q	recherche textuelle insensible à la casse dans le titre, le compte rendu IA et la transcription
tag	nom de tag, répétable (tag=a&tag=b)
client	nom du dossier client
recorded_after, recorded_before	date de la réunion (dates ISO 8601)
created_after, created_before	date d’ajout dans Meetingize
status	draft, queued, processing, completed, failed
limit, cursor	pagination

Chaque réunion possède id, title, status, recorded_at, created_at, transcribe_only, duration_seconds, language, source, recording_type, tags, client, has_transcript, has_summary et web_url (lien pour l’ouvrir dans l’application web).

Statut de la réunion

Statut	Signification
draft	en cours d’enregistrement dans l’application web ou mobile, l’audio n’est pas encore finalisé
queued	en attente de traitement
processing	transcription, puis compte rendu IA (la transcription est lisible dès que has_transcript vaut true)
completed	transcription et compte rendu IA disponibles (transcription seule pour les réunions transcribe_only)
failed	le traitement a échoué

Détail d’une réunion

GET /v1/meetings/{id} renvoie une réunion avec tout ce qui la concerne : son summary (compte rendu IA), ses participants, la liste des documents générés et, pour les réunions créées via l’API, son dernier job de traitement.

PATCH /v1/meetings/{id} met à jour le titre, la date, les tags et les participants (scope write:meetings), et DELETE /v1/meetings/{id} supprime définitivement la réunion avec son enregistrement et ses documents. Exemples à l’étape 6 du guide.

Transcription

GET /v1/meetings/{id}/transcript renvoie la transcription diarisée et horodatée.

GET /v1/meetings/{id}/transcript?format=json

Scope read:transcripts. Le format JSON renvoie la langue, la durée, la liste des intervenants et les segments :

{
  "object": "transcript",
  "meeting_id": "1b9e...",
  "language": "fr",
  "speakers": ["SPEAKER_00", "SPEAKER_01"],
  "segments": [
    { "start": 4.5, "end": 9.0, "speaker": "SPEAKER_01", "speaker_name": "Mme Martin",
      "text": "Merci. Le budget est validé pour le trimestre." }
  ]
}

speaker est l’étiquette de diarisation ; speaker_name est renseigné lorsque l’intervenant a été identifié dans Meetingize. Autres formats : md (Markdown), txt (lignes [hh:mm:ss] Speaker: text), srt et vtt (sous-titres, le VTT inclut des balises de voix <v Speaker>). Tant que la transcription est encore en cours, l’endpoint répond 409 transcript_not_ready.

Compte rendu IA de la réunion

GET /v1/meetings/{id}/summary renvoie le compte rendu IA de la réunion.

GET /v1/meetings/{id}/summary?format=json   # ou format=md

Renvoie le compte rendu en Markdown (markdown) et, quand il est disponible, le résultat structured produit par l’IA (résumé, minutes, points clés, actions à mener, identification des intervenants). 409 summary_not_ready pendant le traitement.

Participants

GET /v1/meetings/{id}/participants liste les personnes de la réunion avec leur id (par_<n>), leur name, leur email et les speaker_labels qui leur sont attribués. Les intervenants de la transcription pas encore attribués à une personne apparaissent avec id: null. Attribuez-les avec PATCH /v1/meetings/{id}.

Export prêt pour un LLM

GET /v1/meetings/{id}/export regroupe tout ce qui concerne une réunion en texte prêt à coller dans un LLM.

GET /v1/meetings/{id}/export?format=md&max_tokens=24000&lang=en

Scopes read:meetings et read:transcripts. Regroupe un prompt d’amorçage, les métadonnées, les participants, le compte rendu IA et la transcription diarisée et horodatée, découpés en parties d’au plus max_tokens tokens (de 2 000 à 200 000, 24 000 par défaut) afin que chaque partie tienne dans la fenêtre de contexte d’un modèle. lang (fr par défaut, ou en) définit la langue du prompt d’amorçage. format=json renvoie parts[] avec index, total, tokens et content ; format=md concatène les parties avec des séparateurs --- Part i/n ---.

C’est l’export à coller à la main dans ChatGPT ou Claude. Pour laisser votre assistant récupérer lui-même les réunions, utilisez le serveur MCP.