Lister les utilisateurs avec l'API Slack
Liste les membres du workspace avec id, name, real_name et profile.email, y compris les bots (is_bot) et les membres désactivés (deleted). La réponse contient members et response_metadata.next_cursor : passez-le comme cursor pour lire la page suivante.
- Identifiant
- slack_list_users
L'appel
POST https://connect.reportei.com/api/tools/slack_list_users/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"limit": 1
}
}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 |
|---|---|---|---|
| limit | integer | Non | Members per page, for example 200. Without it Slack tries to return everyone at once, which fails on large workspaces. |
| cursor | string | Non | The response_metadata.next_cursor of the previous response. |
| include_locale | boolean | Non | true adds the locale of each member. |
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_list_users. 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.
