
Communication
Zoom dans votre produit et vos agents IA, via une API
Le toolkit Zoom couvre les réunions, inscrits, présence et enregistrements cloud d'un utilisateur Zoom : créer, modifier et supprimer des réunions, obtenir les invitations, inscrire des personnes, lire les réunions passées, participants et enregistrements. Avec Connect, votre produit ou agent IA appelle ces opérations par un seul endpoint, pendant que Connect stocke et renouvelle les identifiants OAuth et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/zoom_create_meeting/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"userId": "<userId>"
}
}Fonctionnement
Du client connecté au premier appel à Zoom.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Zoom. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Zoom.
Planifier des réunions depuis le produit
Quand une réservation est confirmée dans votre SaaS, créez la réunion pour l'hôte et envoyez le join_url ou le texte d'invitation aux invités.
Inscription à des webinaires
Inscrivez chaque personne à une réunion dont l'inscription est activée et conservez son join_url personnel et son registrant_id.
Présence et enregistrements
Une fois la réunion terminée, listez qui a rejoint et pendant combien de temps, et récupérez les enregistrements cloud pour alimenter un CRM ou un agent IA.
Tools
12 tools Zoom
- Obtenir un utilisateurGETRenvoie le profil d'un utilisateur : nom, email, fuseau horaire, ID de réunion personnelle et type de forfait.
- Lister les réunionsGETListe les réunions planifiées d'un utilisateur ; les réunions instantanées ne sont pas incluses. La réponse contient meetings et next_page_token : passez next_page_token pour lire la page suivante.
- Obtenir une réunionGETRenvoie une réunion avec join_url, start_url, paramètres et, pour une réunion récurrente, ses occurrences. Le start_url expire au bout de deux heures : relisez-le ici quand nécessaire.
- Créer une réunionPOSTPlanifie une réunion pour un utilisateur et la renvoie avec join_url et start_url. Zoom accepte jusqu'à 100 de ces appels par jour et par hôte.
- Mettre à jour une réunionPATCHMet à jour une réunion ; seuls les champs envoyés changent. Avec occurrence_id, modifie une occurrence d'une réunion récurrente. Zoom accepte jusqu'à 100 mises à jour par jour et par réunion.
- Supprimer une réunionDELETESupprime une réunion. Sans occurrence_id, une réunion récurrente est supprimée avec toutes ses occurrences.
- Obtenir l'invitation d'une réunionGETRenvoie le texte d'invitation d'une réunion, avec le lien et les informations d'appel, prêt à envoyer aux invités.
- Lister les inscrits d'une réunionGETListe les inscrits d'une réunion dont l'inscription est activée. Seuls les inscrits approuvés reviennent, sauf indication contraire de status. Nécessite un forfait Pro ou supérieur. Passez next_page_token pour lire la page suivante.
- Inscrire un participant à la réunionPOSTInscrit une personne à une réunion dont l'inscription est activée et renvoie le registrant_id et le join_url personnel. Zoom peut envoyer un email à l'inscrit, selon les paramètres de la réunion.
- Obtenir une réunion passéeGETRenvoie les détails d'une réunion déjà terminée : heure de début et de fin, durée et nombre de participants. Uniquement les réunions de la dernière année.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/zoom, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Zoom
Dois-je intégrer l'API Zoom moi-même ?
Non. Connect fournit 12 tools Zoom décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Zoom ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
