Contratti di raccolta — Slack
01Come leggere questa pagina #sec_487f6ca2
Ogni risorsa che REVIEWIT può raccogliere per Slack ha un contratto pubblicato. Si legge come una referencia API: ciò che REVIEWIT chiama sul servizio raccolto e attraverso quale mezzo, ciò che il contratto richiede affinché la raccolta si esegua e i dati che REVIEWIT conserva. REVIEWIT esegue solo letture.
- Chiamate: le richieste che REVIEWIT invia al servizio raccolto, tutte in lettura.
- Requisiti: ciascuno deve essere soddisfatto. La sua natura indica cosa richiede: un diritto da concedere all'identificativo, una condizione di amministrazione (un'impostazione o un'assegnazione presso il fornitore che il token non porta, verificata da una chiamata reale in lettura) o l'appartenenza dell'identificativo allo spazio di lavoro Slack della connessione. La regola indica quante opzioni sono necessarie: « richiesta » per l'unica opzione, « una a scelta » quando una sola è sufficiente (sono ordinate dalla più ristretta alla più ampia: preferire la prima), « tutte » o « N a scelta tra M ».
- Condizioni di funzionamento: ciò che REVIEWIT verifica prima di ogni raccolta, oltre ai requisiti.
- Freschezza: l'età massima delle verifiche su cui si basa il verdetto, fissata da ogni contratto (qui: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale). REVIEWIT ripete automaticamente entro questo termine le verifiche che sa eseguire (token ottenuto, servizio che risponde); « Verificare i diritti », nel menu della connessione, li ripete su richiesta. Finché la chiamata reale non è stata effettuata, i diritti rimangono non verificati.
- Dati conservati: i campi che REVIEWIT conserva di ogni oggetto; il ruolo indica cosa ne fa la revisione.
Il verdetto di ogni risorsa, per la vostra connessione, si legge sulla sua scheda. Una risorsa che la connessione non raccoglie può comunque essere alimentata dall'import di un rapporto (« Importare un rapporto »).
02Come REVIEWIT verifica i requisiti #sec_b6669f0d
Il token Slack non porta i suoi diritti: il contratto richiede che vengano verificati mediante una chiamata reale in lettura. REVIEWIT non effettua ancora questa chiamata per Slack: verifica che il token sia ottenuto e che il servizio risponda, ma non i diritti elencati qui. Le risorse vengono visualizzate come « Non verificato »; possono comunque essere alimentate dall'import di un rapporto (« Importare un rapporto »).
03I percorsi di chiamata #sec_1058f591
Un percorso indica quale token REVIEWIT ottiene per l'identificatore: chi lo rilascia e per quale audience. Gli indirizzi chiamati sono indicati nelle chiamate di ogni risorsa; un percorso che inizia con « / » è chiamato sull'audience del token del suo percorso.
| Percorso | Token rilasciato da | Audience del token | Autenticazione dell'identificatore |
|---|---|---|---|
| slack.web-api.reviewit.app-token | https://slack.com/api/oauth.v2.access | https://slack.com/api | token o secret API |
04Conversazioni · Canali Slack Connect #sec_6a07c744
slack.conversations.connect-channels:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Canali condivisi con un'organizzazione esterna (Slack Connect)
Chiamate
- GET conversations.list (is_ext_shared)
- GET conversations.info
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutte | channels:read e groups:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Frescura: verifiche di meno di 24 ore; i diritti devono essere constatati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obligatorio |
|---|---|---|---|
| ChannelId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| ConnectedTeamIds | contesto, senza effetto sulla revisione | testo | no |
| ConnectedTeamNames | contesto, senza effetto sulla revisione | testo | no |
| IsExtShared | contesto, senza effetto sulla revisione | booleano | no |
| IsPendingExtShared | contesto, senza effetto sulla revisione | booleano | no |
| NumMembers | contesto, senza effetto sulla revisione | intero | no |
05Conversazioni · Membri del canale #sec_b2cc14d6
slack.conversations.memberships:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Membri di un canale: persone, bot e membri esterni (Slack Connect). Chiave di riga: ChannelId | UserId.
Chiamate
- GET conversations.list?types=public_channel,private_channel
- GET conversations.members
- GET users.list (Handle, Email, IsBot, IsExternal
- profile.email con users:read.email)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutte | channels:read e groups:read |
| Diritto | tutte | users:read e users:read.email |
| Appartenenza | richiesta | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| ChannelId | contesto, senza effetto sulla revisione | testo | sì |
| ChannelName | contesto, senza effetto sulla revisione | testo | no |
| UserId | contesto, senza effetto sulla revisione | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| IsBot | contesto, senza effetto sulla revisione | booleano | no |
| IsExternal | contesto, senza effetto sulla revisione | booleano | no |
06Conversazioni · Canali privati #sec_6fd090de
slack.conversations.private-channels:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Canali privati visibili dall'applicazione
Chiamate
- GET conversations.list?types=private_channel
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | groups:read |
| Appartenenza | richiesta | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| ChannelId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Creator | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| IsArchived | contesto, senza effetto sulla revisione | booleano | no |
| NumMembers | contesto, senza effetto sulla revisione | intero | no |
| Topic | contesto, senza effetto sulla revisione | testo | no |
| Purpose | contesto, senza effetto sulla revisione | testo | no |
07Conversazioni · Canali pubblici #sec_ad6b215b
slack.conversations.public-channels:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Canali pubblici, il loro creatore e il loro stato di archiviazione
Chiamate
- GET conversations.list?types=public_channel
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | channels:read |
| Appartenenza | richiesta | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| ChannelId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Creator | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| IsArchived | contesto, senza effetto sulla revisione | booleano | no |
| NumMembers | contesto, senza effetto sulla revisione | intero | no |
| Topic | contesto, senza effetto sulla revisione | testo | no |
| Purpose | contesto, senza effetto sulla revisione | testo | no |
08Directory · Ospiti #sec_e2730131
slack.directory.guests:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Ospiti monocanale e ospiti multicanale
Chiamate
- GET users.list (is_restricted, is_ultra_restricted
- profile.email con users:read.email)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutte | users:read e users:read.email |
| Appartenenza | richiesta | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| UserId | chiave dell'oggetto | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | sì |
| RealName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | no | |
| GuestType | contesto, senza effetto sulla revisione | testo | no |
| InvitedBy | contesto, senza effetto sulla revisione | testo | no |
| ExpiresOn | contesto, senza effetto sulla revisione | data e ora | no |
| Deleted | contesto, senza effetto sulla revisione | booleano | no |
09Directory · Inviti pendenti #sec_ea68488c
slack.directory.pending-invitations:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Richieste di invito sottoposte all'approvazione di un amministratore, in attesa o approvate
Metodi riservati alle organizzazioni Slack Enterprise: richiedono un token di applicazione installata sull'organizzazione da uno dei suoi proprietari o amministratori.
Chiamate
- GET admin.inviteRequests.list
- GET admin.inviteRequests.approved.list
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | admin.invites:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| InviteId | chiave dell'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| InvitedBy | contesto, senza effetto sulla revisione | testo | no |
| InvitedOn | contesto, senza effetto sulla revisione | data e ora | no |
| InviteType | contesto, senza effetto sulla revisione | testo | no |
| Channels | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
10Directory · Utenti e bot #sec_5512c006
slack.directory.users:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Account dello spazio di lavoro: membri, bot, account disattivati
Chiamate
- GET users.list (utenti e bot
- profile.email con users:read.email)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutti | users:read e users:read.email |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| UserId | chiave dell'oggetto | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | sì |
| RealName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | no | |
| IsAdmin | contesto, senza effetto sulla revisione | booleano | no |
| IsOwner | contesto, senza effetto sulla revisione | booleano | no |
| IsBot | contesto, senza effetto sulla revisione | booleano | no |
| Deleted | contesto, senza effetto sulla revisione | booleano | no |
| Updated | contesto, senza effetto sulla revisione | data e ora | no |
11Ruoli privilegiati · Amministratori e ruoli personalizzati #sec_26a1dabe
slack.privileged-roles.admins:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Proprietari, amministratori e ruoli personalizzati. Chiave di riga: UserId | RoleType | Scope (Scope vuoto per is_admin e is_owner).
Metodi riservati alle organizzazioni Slack Enterprise: richiedono un token di applicazione installata sull'organizzazione da uno dei suoi proprietari o amministratori.
Chiamate
- GET users.list (is_admin, is_owner
- profile.email con users:read.email)
- GET admin.roles.listAssignments
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutti | users:read e users:read.email |
| Diritto | richiesto | admin.roles:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AssignmentKey | chiave dell'oggetto | testo | sì |
| UserId | contesto, senza effetto sulla revisione | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | sì |
| RealName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | no | |
| RoleName | visualizzato per riconoscere l'oggetto | testo | no |
| RoleType | contesto, senza effetto sulla revisione | testo | sì |
| Scope | contesto, senza effetto sulla revisione | testo | no |
12App di terze parti · App installate #sec_6cfa3904
slack.apps.installed-apps:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Applicazioni approvate sullo spazio di lavoro o sull'organizzazione, e le loro portate
Metodi riservati alle organizzazioni Slack Enterprise: richiedono un token di applicazione installata sull'organizzazione da uno dei suoi proprietari o amministratori.
Chiamate
- GET admin.apps.approved.list
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | admin.apps:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://slack.com/api risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AppId | chiave dell'oggetto | testo | sì |
| AppName | visualizzato per riconoscere l'oggetto | testo | sì |
| Publisher | contesto, senza effetto sulla revisione | testo | no |
| InstalledByUserId | contesto, senza effetto sulla revisione | testo | no |
| InstalledOn | contesto, senza effetto sulla revisione | data e ora | no |
| Scopes | contesto, senza effetto sulla revisione | testo | no |
| IsDirectoryApproved | contesto, senza effetto sulla revisione | booleano | no |
13Gruppi di utenti · Membri del gruppo di utenti #sec_cff1c96d
slack.groups.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Appartenenze a un gruppo di utenti. Chiave di riga : UserGroupId | UserId.
Chiamate
- GET usergroups.users.list
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | usergroups:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://slack.com/api risponde
Aggiornamento : verifiche inferiori a 24 ore ; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| UserGroupId | contesto, senza effetto sulla revisione | testo | sì |
| UserGroupName | contesto, senza effetto sulla revisione | testo | no |
| UserId | contesto, senza effetto sulla revisione | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no |
14Gruppi di utenti #sec_6b350c1e
slack.groups.user-groups:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via slack.web-api.reviewit.app-token
Gruppi di utenti, il loro identificativo @ e il numero di membri
Chiamate
- GET usergroups.list
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | usergroups:read |
| Appartenenza | richiesto | l'identificativo appartiene allo spazio di lavoro Slack della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://slack.com/api risponde
Aggiornamento : verifiche inferiori a 24 ore ; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| UserGroupId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Handle | visualizzato per riconoscere l'oggetto | testo | no |
| Description | contesto, senza effetto sulla revisione | testo | no |
| DateCreate | contesto, senza effetto sulla revisione | data e ora | no |
| DateDelete | contesto, senza effetto sulla revisione | data e ora | no |
| UserCount | contesto, senza effetto sulla revisione | intero | no |
15Per andare oltre #sec_a28ee5aa
- Comprendere una connessione di raccolta
- Riferimento dei diritti per risorsa
- Leggere un verdetto