Communication
Google Chat dans votre produit et vos agents IA, via une API
Le toolkit Google Chat couvre les espaces, messages directs, messages, réactions et membres, en agissant toujours comme l'utilisateur qui s'est connecté. Votre client autorise Google une fois via OAuth, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke et renouvelle les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/google_chat_create_space/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"space": {}
}
}Fonctionnement
Du client connecté au premier appel à Google Chat.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Google Chat. 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 Google Chat.
Notifier les équipes dans leur chat
Envoyez un message depuis votre produit vers un espace ou un message direct, ou répondez dans un fil existant quand une alerte est mise à jour.
Créer un espace par projet
Créez un espace, invitez les bonnes personnes et ajoutez des membres plus tard, quand quelqu'un rejoint le compte ou le projet.
Un agent qui comprend le chat
Laissez un agent IA rechercher des messages dans les espaces de l'utilisateur, lire une conversation et répondre ou réagir en son nom.
Tools
11 tools Google Chat
- Lister les espacesGETListe les espaces, discussions de groupe et messages directs dont l'utilisateur est membre, avec name, displayName et spaceType. La partie du name après spaces/ est le spaceId des autres outils, et les discussions de groupe et messages directs n'apparaissent qu'après le premier message.
- Obtenir un message directGETRenvoie l'espace de message direct entre l'utilisateur et une autre personne ; la partie du name après spaces/ est le spaceId de Send message. Répond 404 quand les deux n'ont pas encore de message direct, que Create space démarre.
- Créer un espacePOSTCrée un espace avec l'utilisateur et invite d'autres personnes. SPACE exige displayName et accepte jusqu'à 49 personnes ; GROUP_CHAT exige au moins deux personnes et aucun nom ; DIRECT_MESSAGE exige exactement une personne et renvoie le message direct existant s'il y en a un.
- Lister les messagesGETListe les messages d'un espace, du plus ancien au plus récent par défaut, avec name, sender, createTime, text et thread. Les expéditeurs arrivent sous la forme users/ suivi d'un id, sans le nom affiché ; envoyez nextPageToken comme pageToken pour la page suivante.
- Rechercher des messagesPOSTRecherche des messages par mots-clés dans tous les espaces et messages directs de l'utilisateur, du plus récent au plus ancien. Chaque résultat contient le message, dont le name porte les ids de l'espace et du message ; les messages d'applications Chat, les messages privés et les espaces en sourdine sont exclus.
- Envoyer un messagePOSTEnvoie un message texte de l'utilisateur à un espace ou un message direct. Pour répondre dans un fil, envoyez thread avec le nom du fil issu de List messages et messageReplyOption ; sans messageReplyOption le message ouvre un nouveau fil.
- Mettre à jour un messagePATCHModifie le texte d'un message, avec updateMask défini sur text.
- Supprimer un messageDELETESupprime un message. Un message avec des réponses dans un fil n'est supprimé qu'avec force true, ce qui supprime aussi les réponses.
- Créer une réactionPOSTAjoute une réaction emoji de l'utilisateur à un message.
- Lister les membresGETListe les membres d'un espace avec role et state. Les membres arrivent sous la forme users/ suivi d'un id, sans le nom affiché ; envoyez nextPageToken comme pageToken pour la page suivante.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_chat, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Google Chat
Dois-je intégrer l'API Google Chat moi-même ?
Non. Connect fournit 11 tools Google Chat 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 Google Chat ?
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.
