Supprimer un message avec l'API Slack
Supprime un message publié par le bot de l'app. Les messages de personnes ne peuvent pas être supprimés avec cette connexion.
- Identifiant
- slack_delete_message
L'appel
POST https://connect.reportei.com/api/tools/slack_delete_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"channel": "<channel>",
"ts": "<ts>"
}
}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 |
|---|---|---|---|
| channel | string | Oui | The channel of the message, as Send message returned it. |
| ts | string | Oui | The ts of the message, from Send message or List messages. |
Connexions possibles
Votre client connecte son compte Slack 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/slack, 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/slack_delete_message. Il devient la définition de tool de votre agent sans conversion.
Autres tools Slack
- Lister les conversationsGETListe les canaux du workspace : tous les canaux publics et les canaux privés auxquels l'app a été ajoutée. L'id d'un canal est l'argument channel des autres tools, et is_member indique si l'app en fait partie. La réponse contient channels et response_metadata.next_cursor : passez-le comme cursor pour lire la page suivante.
- Créer une conversationPOSTCrée un canal public ou privé avec l'app comme membre et le renvoie avec son id. Ajoutez-y des personnes avec Invite members to conversation.
- Rejoindre une conversationPOSTAjoute l'app à un canal public et renvoie le canal. L'app doit en être membre pour lire les messages d'un canal ou y publier. Un canal privé ne peut pas être rejoint ainsi : un membre y ajoute l'app dans Slack.
- Inviter des membres dans la conversationPOSTInvite des membres du workspace dans un canal où l'app se trouve. Si l'un des ids échoue, personne n'est invité, sauf si force vaut true.
- Lister les messagesGETListe les messages d'un canal dont l'app est membre, du plus récent au plus ancien. Les réponses de fil ne sont pas incluses : lisez-les avec List thread replies. La réponse contient messages, has_more et response_metadata.next_cursor : passez-le comme cursor pour lire la page suivante. Une app installée hors du Slack Marketplace peut être limitée à 15 messages par appel et un appel par minute.
- Lister les réponses d'un filGETListe un fil d'un canal dont l'app est membre : le message parent suivi de ses réponses. La réponse contient messages, has_more et response_metadata.next_cursor : passez-le comme cursor pour lire la page suivante. Une app installée hors du Slack Marketplace peut être limitée à 15 messages par appel et un appel par minute.
- Envoyer un messagePOSTPublie un message comme le bot de l'app et le renvoie avec channel et ts, le couple que demandent Update message et Delete message. Envoyez text, markdown_text ou blocks. L'app doit être membre du canal : appelez d'abord Join conversation pour un canal public.
- Planifier un messagePOSTPlanifie un message du bot de l'app pour un moment jusqu'à 120 jours à l'avance et renvoie son scheduled_message_id. Envoyez text, markdown_text ou blocks. L'app doit être membre du canal, et un canal accepte au plus 30 messages planifiés dans les mêmes 5 minutes.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
