Inviter des membres dans la conversation avec l'API Slack
Invite 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.
- Identifiant
- slack_invite_conversation_members
L'appel
POST https://connect.reportei.com/api/tools/slack_invite_conversation_members/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"channel": "<channel>",
"users": "<users>"
}
}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 | Id of the channel, from List conversations or Create conversation. |
| users | string | Oui | Comma-separated ids of the users to invite, up to 1000, from List users or Get user by email. |
| force | boolean | Non | true invites the valid ids and skips the ones that fail. |
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_invite_conversation_members. 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.
- 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.
- 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.
