Supprimer un message avec l'API Google Chat
Supprime 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.
- Identifiant
- google_chat_delete_message
L'appel
POST https://connect.reportei.com/api/tools/google_chat_delete_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"spaceId": "<spaceId>",
"messageId": "<messageId>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| spaceId | string | Oui | Id of the space: the part after spaces/ in the name from List spaces. |
| messageId | string | Oui | Id of the message: the part after messages/ in its name, from List messages, Search messages or Send message. |
| force | boolean | Non | true also deletes the replies of the message. |
Connexions possibles
Votre client connecte son compte Google Chat une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/google_chat_delete_message. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- Créer une réactionPOSTAjoute une réaction emoji de l'utilisateur à un message.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
