Démarrage rapide

Ce démarrage rapide vous emmène de zéro à vos premiers appels API. Vous avez besoin d’un compte Meetingize avec au moins une réunion traitée.

1. Créer une clé API

1. Connectez-vous à l’application web Meetingize.
2. Ouvrez le menu utilisateur, puis Developers (Paramètres > Développeurs).
3. Cliquez sur Create a key, donnez-lui un nom et choisissez ses scopes. Pour ce démarrage rapide, gardez read:meetings, read:transcripts, read:documents, write:meetings et write:documents.
4. Copiez la clé maintenant : elle n’est affichée qu’une seule fois. Elle ressemble à mtgz_live_k7Hq2x9a_....

export MEETINGIZE_API_KEY="mtgz_live_..."
export MEETINGIZE_API="https://app.meetingize.com/api/v1"

2. Vérifier qui vous êtes

curl -s "$MEETINGIZE_API/me" -H "Authorization: Bearer $MEETINGIZE_API_KEY"

La réponse indique le compte, l’offre, le type d’identifiant (api_key ou oauth), ses scopes et votre limite de débit.

3. Lister et rechercher des réunions

curl -s "$MEETINGIZE_API/meetings?limit=5" -H "Authorization: Bearer $MEETINGIZE_API_KEY"
curl -s "$MEETINGIZE_API/meetings?q=budget&created_after=2026-07-01T00:00:00Z" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY"

q recherche dans les titres, les comptes rendus IA et les transcriptions (insensible à la casse). Les résultats sont paginés avec un curseur : renvoyez next_cursor en tant que cursor tant que has_more vaut true.

4. Lire une transcription et le compte rendu IA

MEETING_ID="1b9e..."   # un id obtenu lors de l'appel précédent
curl -s "$MEETINGIZE_API/meetings/$MEETING_ID/transcript?format=md" -H "Authorization: Bearer $MEETINGIZE_API_KEY"
curl -s "$MEETINGIZE_API/meetings/$MEETING_ID/summary?format=md" -H "Authorization: Bearer $MEETINGIZE_API_KEY"

Les transcriptions sont par défaut des segments JSON structurés (start, end, speaker, speaker_name, text), ou aux formats md, txt, srt et vtt. Besoin de tout pour un LLM ? Utilisez l’export prêt pour LLM.

5. Envoyer un enregistrement

curl -s -X POST "$MEETINGIZE_API/meetings" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F file=@my-meeting.m4a -F title="Weekly sync" -F language=en

Vous obtenez 202 Accepted avec la nouvelle réunion (status: "queued") et son job de traitement. Le déroulé complet (statuts, polling ou webhooks, ce que vous recevez à chaque étape) se trouve dans Créer une réunion et récupérer les résultats. Votre clé a besoin du scope write:meetings.

6. Générer un document

curl -s -X POST "$MEETINGIZE_API/meetings/$MEETING_ID/documents" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"prompt": "Write a client follow-up email with the decisions and next steps", "title": "Follow-up"}'

La réponse est 202 Accepted avec un job. Interrogez-le jusqu’à ce que status soit completed, puis lisez le document :

curl -s "$MEETINGIZE_API/jobs/job_..." -H "Authorization: Bearer $MEETINGIZE_API_KEY"
curl -s "$MEETINGIZE_API/documents/doc_...?format=md" -H "Authorization: Bearer $MEETINGIZE_API_KEY"

La génération de document consomme des tokens LLM, facturés sur votre forfait API.

7. Être notifié plutôt que d’interroger

Enregistrez un endpoint webhook dans Settings > Developers (ou avec POST /v1/webhook_endpoints et le scope webhooks), abonnez-vous à document.generated, et vérifiez la signature de chaque livraison.

Vous préférez Python, Node ou votre assistant IA ?

• L’explorateur d’API génère du code dans de nombreux langages et vous laisse tester des appels avec votre clé.
• La CLI meetingize enveloppe tout ce qui précède en une seule ligne de commande.
• Pour utiliser vos réunions depuis Claude ou ChatGPT sans écrire de code, connectez le serveur MCP.