Contrats de collecte — Slack
01Comment lire cette page #sec_487f6ca2
Chaque ressource que REVIEWIT sait collecter pour Slack a un contrat publié. Il se lit comme une référence d'API : ce que REVIEWIT appelle sur le service collecté et par quelle voie, ce que le contrat exige pour que la collecte s'exécute, et les données que REVIEWIT conserve. REVIEWIT ne fait que des lectures.
- Appels : les requêtes que REVIEWIT adresse au service collecté, toutes en lecture.
- Exigences : chacune doit être satisfaite. Sa nature dit ce qu'elle demande : un droit à accorder à l'identifiant, une condition d'administration (un réglage ou une attribution chez le fournisseur que le jeton ne porte pas, constaté par un appel réel en lecture), ou l'appartenance de l'identifiant à l'espace de travail Slack de la connexion. La règle dit combien d'options il faut : « requise » pour l'unique option, « une au choix » quand une seule suffit (elles sont rangées de la plus étroite à la plus large : préférez la première), « toutes », ou « N au choix parmi M ».
- Conditions de fonctionnement : ce que REVIEWIT constate avant chaque collecte, au-delà des exigences.
- Fraîcheur : l'âge maximal des vérifications sur lesquelles le verdict s'appuie, fixé par chaque contrat (ici : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel). REVIEWIT refait automatiquement dans ce délai les vérifications qu'il sait faire (jeton obtenu, service qui répond) ; « Vérifier les droits », dans le menu de la connexion, les refait à la demande. Tant que l'appel réel n'est pas fait, les droits restent non constatés.
- Données conservées : les champs que REVIEWIT garde de chaque objet ; le rôle dit ce que la revue en fait.
Le verdict de chaque ressource, pour votre connexion, se lit sur sa fiche. Une ressource que la connexion ne collecte pas peut toujours être alimentée par l'import d'un rapport (« Importer un rapport »).
02Comment REVIEWIT vérifie les exigences #sec_b6669f0d
Le jeton Slack ne porte pas ses droits : le contrat exige qu'ils soient constatés par un appel réel, en lecture. REVIEWIT ne fait pas encore cet appel pour Slack : il constate que le jeton est obtenu et que le service répond, mais pas les droits listés ici. Les ressources s'affichent « Non vérifié » ; elles peuvent toujours être alimentées par l'import d'un rapport (« Importer un rapport »).
03Les voies d'appel #sec_1058f591
Une voie dit quel jeton REVIEWIT obtient pour l'identifiant : qui le délivre et pour quelle audience. Les adresses appelées figurent dans les appels de chaque ressource ; un chemin qui commence par « / » s'appelle sur l'audience du jeton de sa voie.
| Voie | Jeton délivré par | Audience du jeton | Authentification de l'identifiant |
|---|---|---|---|
| slack.web-api.reviewit.app-token | https://slack.com/api/oauth.v2.access | https://slack.com/api | jeton ou secret d'API |
04Conversations · Slack Connect channels #sec_6a07c744
slack.conversations.connect-channels:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Canaux partagés avec une organisation externe (Slack Connect)
Appels
- GET conversations.list (is_ext_shared)
- GET conversations.info
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | channels:read et groups:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| ChannelId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| ConnectedTeamIds | contexte, sans effet sur la revue | texte | non |
| ConnectedTeamNames | contexte, sans effet sur la revue | texte | non |
| IsExtShared | contexte, sans effet sur la revue | booléen | non |
| IsPendingExtShared | contexte, sans effet sur la revue | booléen | non |
| NumMembers | contexte, sans effet sur la revue | entier | non |
05Conversations · Channel members #sec_b2cc14d6
slack.conversations.memberships:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Membres d'un canal : personnes, bots et membres externes (Slack Connect). Clé de ligne : ChannelId | UserId.
Appels
- GET conversations.list?types=public_channel,private_channel
- GET conversations.members
- GET users.list (Handle, Email, IsBot, IsExternal
- profile.email avec users:read.email)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | channels:read et groups:read |
| Droit | toutes | users:read et users:read.email |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| ChannelId | contexte, sans effet sur la revue | texte | oui |
| ChannelName | contexte, sans effet sur la revue | texte | non |
| UserId | contexte, sans effet sur la revue | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| IsBot | contexte, sans effet sur la revue | booléen | non |
| IsExternal | contexte, sans effet sur la revue | booléen | non |
06Conversations · Private channels #sec_6fd090de
slack.conversations.private-channels:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Canaux privés visibles de l'application
Appels
- GET conversations.list?types=private_channel
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | groups:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| ChannelId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Creator | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| IsArchived | contexte, sans effet sur la revue | booléen | non |
| NumMembers | contexte, sans effet sur la revue | entier | non |
| Topic | contexte, sans effet sur la revue | texte | non |
| Purpose | contexte, sans effet sur la revue | texte | non |
07Conversations · Public channels #sec_ad6b215b
slack.conversations.public-channels:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Canaux publics, leur créateur et leur état d'archivage
Appels
- GET conversations.list?types=public_channel
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | channels:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| ChannelId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Creator | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| IsArchived | contexte, sans effet sur la revue | booléen | non |
| NumMembers | contexte, sans effet sur la revue | entier | non |
| Topic | contexte, sans effet sur la revue | texte | non |
| Purpose | contexte, sans effet sur la revue | texte | non |
08Directory · Guests #sec_e2730131
slack.directory.guests:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Invités monocanaux et invités multicanaux
Appels
- GET users.list (is_restricted, is_ultra_restricted
- profile.email avec users:read.email)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | users:read et users:read.email |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserId | clé de l'objet | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | oui |
| RealName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | non | |
| GuestType | contexte, sans effet sur la revue | texte | non |
| InvitedBy | contexte, sans effet sur la revue | texte | non |
| ExpiresOn | contexte, sans effet sur la revue | date et heure | non |
| Deleted | contexte, sans effet sur la revue | booléen | non |
09Directory · Pending invitations #sec_ea68488c
slack.directory.pending-invitations:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Demandes d'invitation soumises à l'approbation d'un administrateur, en attente ou approuvées
Méthodes réservées aux organisations Slack Enterprise : elles demandent un jeton d'application installée sur l'organisation par un de ses propriétaires ou administrateurs.
Appels
- GET admin.inviteRequests.list
- GET admin.inviteRequests.approved.list
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | admin.invites:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| InviteId | clé de l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | oui | |
| InvitedBy | contexte, sans effet sur la revue | texte | non |
| InvitedOn | contexte, sans effet sur la revue | date et heure | non |
| InviteType | contexte, sans effet sur la revue | texte | non |
| Channels | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
10Directory · Users and bots #sec_5512c006
slack.directory.users:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Comptes de l'espace de travail : membres, bots, comptes désactivés
Appels
- GET users.list (utilisateurs et bots
- profile.email avec users:read.email)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | users:read et users:read.email |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserId | clé de l'objet | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | oui |
| RealName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | non | |
| IsAdmin | contexte, sans effet sur la revue | booléen | non |
| IsOwner | contexte, sans effet sur la revue | booléen | non |
| IsBot | contexte, sans effet sur la revue | booléen | non |
| Deleted | contexte, sans effet sur la revue | booléen | non |
| Updated | contexte, sans effet sur la revue | date et heure | non |
11Privileged roles · Administrators and custom roles #sec_26a1dabe
slack.privileged-roles.admins:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Propriétaires, administrateurs et rôles personnalisés. Clé de ligne : UserId | RoleType | Scope (Scope vide pour is_admin et is_owner).
Méthodes réservées aux organisations Slack Enterprise : elles demandent un jeton d'application installée sur l'organisation par un de ses propriétaires ou administrateurs.
Appels
- GET users.list (is_admin, is_owner
- profile.email avec users:read.email)
- GET admin.roles.listAssignments
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | users:read et users:read.email |
| Droit | requise | admin.roles:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AssignmentKey | clé de l'objet | texte | oui |
| UserId | contexte, sans effet sur la revue | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | oui |
| RealName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | non | |
| RoleName | affiché pour reconnaître l'objet | texte | non |
| RoleType | contexte, sans effet sur la revue | texte | oui |
| Scope | contexte, sans effet sur la revue | texte | non |
12Third-party apps · Installed apps #sec_6cfa3904
slack.apps.installed-apps:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Applications approuvées sur l'espace de travail ou l'organisation, et leurs portées
Méthodes réservées aux organisations Slack Enterprise : elles demandent un jeton d'application installée sur l'organisation par un de ses propriétaires ou administrateurs.
Appels
- GET admin.apps.approved.list
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | admin.apps:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AppId | clé de l'objet | texte | oui |
| AppName | affiché pour reconnaître l'objet | texte | oui |
| Publisher | contexte, sans effet sur la revue | texte | non |
| InstalledByUserId | contexte, sans effet sur la revue | texte | non |
| InstalledOn | contexte, sans effet sur la revue | date et heure | non |
| Scopes | contexte, sans effet sur la revue | texte | non |
| IsDirectoryApproved | contexte, sans effet sur la revue | booléen | non |
13User groups · User group members #sec_cff1c96d
slack.groups.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Appartenances à un groupe d'utilisateurs. Clé de ligne : UserGroupId | UserId.
Appels
- GET usergroups.users.list
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | usergroups:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| UserGroupId | contexte, sans effet sur la revue | texte | oui |
| UserGroupName | contexte, sans effet sur la revue | texte | non |
| UserId | contexte, sans effet sur la revue | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non |
14User groups #sec_6b350c1e
slack.groups.user-groups:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie slack.web-api.reviewit.app-token
Groupes d'utilisateurs, leur identifiant @ et leur nombre de membres
Appels
- GET usergroups.list
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | usergroups:read |
| Appartenance | requise | l'identifiant appartient à l'espace de travail Slack de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://slack.com/api répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserGroupId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Handle | affiché pour reconnaître l'objet | texte | non |
| Description | contexte, sans effet sur la revue | texte | non |
| DateCreate | contexte, sans effet sur la revue | date et heure | non |
| DateDelete | contexte, sans effet sur la revue | date et heure | non |
| UserCount | contexte, sans effet sur la revue | entier | non |
15Pour aller plus loin #sec_a28ee5aa
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict