Envoyer un message avec l'API Slack
Publie 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.
- Identifiant
- slack_send_message
L'appel
POST https://connect.reportei.com/api/tools/slack_send_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_id>",
"text": "Hello! This is an example message."
}
}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.
Exemple illustratif. Remplacez les tokens, l’UUID de connexion et les données de destination par les vôtres. Cette page n’exécute pas la requête.
Avant l’exécution
- Cet exemple utilise text. Vous pouvez aussi utiliser blocks ou markdown_text ; ne combinez pas markdown_text avec text ou blocks. Avec blocks, ajoutez text pour l’accessibilité et les notifications.
- Connectez le workspace avec une app OAuth autorisée à envoyer et à accéder à la conversation. L’app doit être membre des canaux privés ; les canaux publics dépendent aussi des permissions accordées.
- Vérifiez ok dans la réponse, en plus du statut HTTP. Des erreurs comme no_text, missing_scope et not_in_channel demandent de corriger le contenu, les permissions ou l’accès au canal.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| channel | string | Oui | Id of a channel from List conversations, or the id of a user from List users or Get user by email to message that person directly from the app. |
| text | string | Oui, dans cet exemple texte | Text of the message, plain or in Slack mrkdwn, ideally under 4000 characters. With blocks it is only the notification fallback. |
| markdown_text | string | Alternative à text/blocks | The message in standard Markdown, up to 12000 characters. Do not send it together with text or blocks. |
| blocks | array | Autre option de contenu | Block Kit layout blocks of the message, each with its type, such as section or divider. Send text too, as the notification fallback. |
| thread_ts | string | Non | The ts of a parent message, from List messages, to post this message as a reply in its thread. |
| reply_broadcast | boolean | Non | With thread_ts, true also shows the reply in the channel. |
| unfurl_links | boolean | Non | true shows a preview of text-based links. |
| unfurl_media | boolean | Non | false hides the preview of media links. |
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}.
Format illustratif de réussite
{
"ok": true,
"channel": "C0123456789",
"ts": "1234567890.123456",
"message": {
"text": "Hello! This is an example message."
}
}Le contenu est un exemple, pas une exécution enregistrée. Conservez X-Toolkit-Execution-Id lorsqu’il est renvoyé pour consulter l’exécution. Connect ne gère ni relance ni idempotence : répéter un POST peut répéter l’envoi.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/slack_send_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.
- 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.
- Modifier un messagePOSTModifie un message publié par le bot de l'app et le renvoie. Envoyer text sans blocks remplace les blocks du message par ce texte ; omettre text les conserve.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
