Contratos de coleta — Slack
01Como ler esta página #sec_487f6ca2
Cada recurso que o REVIEWIT pode coletar para o Slack tem um contrato publicado. Ele é lido como uma referência de API: o que o REVIEWIT chama no serviço coletado e por qual meio, o que o contrato exige para que a coleta seja executada e os dados que o REVIEWIT mantém. O REVIEWIT apenas realiza leituras.
- Chamadas: as requisições que o REVIEWIT faz ao serviço coletado, todas em leitura.
- Exigências: cada uma deve ser satisfeita. Sua natureza indica o que ela solicita: um direito a conceder ao identificador, uma condição de administração (uma configuração ou atribuição no provedor que o token não possui, verificada por uma chamada real em leitura) ou a pertença do identificador ao espaço de trabalho Slack da conexão. A regra indica quantas opções são necessárias: « obrigatória » para a opção única, « uma à escolha » quando uma única é suficiente (elas são ordenadas da mais estreita à mais ampla: prefira a primeira), « todas » ou « N à escolha entre M ».
- Condições de funcionamento: o que o REVIEWIT verifica antes de cada coleta, além das exigências.
- Frescura: a idade máxima das verificações nas quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real). O REVIEWIT refaz automaticamente dentro desse prazo as verificações que ele pode realizar (token obtido, serviço que responde); « Verificar direitos », no menu da conexão, os refaz sob demanda. Enquanto a chamada real não for feita, os direitos permanecem não verificados.
- Dados mantidos: os campos que o REVIEWIT mantém de cada objeto; o papel indica o que a revisão faz com eles.
O veredicto de cada recurso, para sua conexão, é lido em sua ficha. Um recurso que a conexão não coleta pode sempre ser alimentado pela importação de um relatório (« Importar um relatório »).
02Como o REVIEWIT verifica as exigências #sec_b6669f0d
O token Slack não possui seus direitos: o contrato exige que eles sejam verificados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Slack: ele verifica que o token foi obtido e que o serviço responde, mas não os direitos listados aqui. Os recursos são exibidos como « Não verificado »; eles podem sempre ser alimentados pela importação de um relatório (« Importar um relatório »).
03As vias de chamada #sec_1058f591
Uma via indica qual token o REVIEWIT obtém para o identificador: quem o emite e para qual audiência. Os endereços chamados estão nos chamadas de cada recurso; um caminho que começa com « / » é chamado na audiência do token de sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| slack.web-api.reviewit.app-token | https://slack.com/api/oauth.v2.access | https://slack.com/api | token ou segredo de API |
04Conversas · Canais Slack Connect #sec_6a07c744
slack.conversations.connect-channels:collect · revisão 3 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Canais compartilhados com uma organização externa (Slack Connect)
Chamadas
- GET conversations.list (is_ext_shared)
- GET conversations.info
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | channels:read e groups:read |
| Pertença | obrigatória | o identificador pertence ao espaço de trabalho Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| ChannelId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| ConnectedTeamIds | contexto, sem efeito sobre a revisão | texto | não |
| ConnectedTeamNames | contexto, sem efeito sobre a revisão | texto | não |
| IsExtShared | contexto, sem efeito sobre a revisão | booleano | não |
| IsPendingExtShared | contexto, sem efeito sobre a revisão | booleano | não |
| NumMembers | contexto, sem efeito sobre a revisão | inteiro | não |
05Conversas · Membros do canal #sec_b2cc14d6
slack.conversations.memberships:collect · revisão 3 do contrato, publicada em 18 outubro 2026 · via slack.web-api.reviewit.app-token
Membros de um canal: pessoas, bots e membros externos (Slack Connect). Chave de linha: ChannelId | UserId.
Chamadas
- GET conversations.list?types=public_channel,private_channel
- GET conversations.members
- GET users.list (Handle, Email, IsBot, IsExternal
- profile.email com users:read.email)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | channels:read e groups:read |
| Direito | todas | users:read e users:read.email |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| ChannelId | contexto, sem efeito sobre a revisão | texto | sim |
| ChannelName | contexto, sem efeito sobre a revisão | texto | não |
| UserId | contexto, sem efeito sobre a revisão | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não | |
| IsBot | contexto, sem efeito sobre a revisão | booleano | não |
| IsExternal | contexto, sem efeito sobre a revisão | booleano | não |
06Conversas · Canais privados #sec_6fd090de
slack.conversations.private-channels:collect · revisão 2 do contrato, publicada em 18 outubro 2026 · via slack.web-api.reviewit.app-token
Canais privados visíveis para a aplicação
Chamadas
- GET conversations.list?types=private_channel
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | groups:read |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| ChannelId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Creator | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| IsArchived | contexto, sem efeito sobre a revisão | booleano | não |
| NumMembers | contexto, sem efeito sobre a revisão | inteiro | não |
| Topic | contexto, sem efeito sobre a revisão | texto | não |
| Purpose | contexto, sem efeito sobre a revisão | texto | não |
07Conversas · Canais públicos #sec_ad6b215b
slack.conversations.public-channels:collect · revisão 2 do contrato, publicada em 18 outubro 2026 · via slack.web-api.reviewit.app-token
Canais públicos, seu criador e seu estado de arquivamento
Chamadas
- GET conversations.list?types=public_channel
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | channels:read |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| ChannelId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Creator | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| IsArchived | contexto, sem efeito sobre a revisão | booleano | não |
| NumMembers | contexto, sem efeito sobre a revisão | inteiro | não |
| Topic | contexto, sem efeito sobre a revisão | texto | não |
| Purpose | contexto, sem efeito sobre a revisão | texto | não |
08Directório · Convidados #sec_e2730131
slack.directory.guests:collect · revisão 3 do contrato, publicada em 18 outubro 2026 · via slack.web-api.reviewit.app-token
Convidados monocanal e convidados multicanal
Chamadas
- GET users.list (is_restricted, is_ultra_restricted
- profile.email com users:read.email)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | users:read e users:read.email |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserId | chave do objeto | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | sim |
| RealName | contexto, sem efeito sobre a revisão | texto | não |
| exibido para reconhecer o objeto | texto | não | |
| GuestType | contexto, sem efeito sobre a revisão | texto | não |
| InvitedBy | contexto, sem efeito sobre a revisão | texto | não |
| ExpiresOn | contexto, sem efeito sobre a revisão | data e hora | não |
| Deleted | contexto, sem efeito sobre a revisão | booleano | não |
09Directory · Convites pendentes #sec_ea68488c
slack.directory.pending-invitations:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Pedidos de convite submetidos à aprovação de um administrador, em espera ou aprovados
Métodos reservados para organizações Slack Enterprise: eles exigem um token de aplicação instalado na organização por um de seus proprietários ou administradores.
Chamadas
- GET admin.inviteRequests.list
- GET admin.inviteRequests.approved.list
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | admin.invites:read |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| InviteId | chave do objeto | texto | sim |
| exibido para reconhecer o objeto | texto | sim | |
| InvitedBy | contexto, sem efeito sobre a revisão | texto | não |
| InvitedOn | contexto, sem efeito sobre a revisão | data e hora | não |
| InviteType | contexto, sem efeito sobre a revisão | texto | não |
| Channels | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
10Directory · Utilizadores e bots #sec_5512c006
slack.directory.users:collect · revisão 3 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Contas do workspace: membros, bots, contas desativadas
Chamadas
- GET users.list (utilizadores e bots
- profile.email com users:read.email)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | users:read e users:read.email |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserId | chave do objeto | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | sim |
| RealName | contexto, sem efeito sobre a revisão | texto | não |
| exibido para reconhecer o objeto | texto | não | |
| IsAdmin | contexto, sem efeito sobre a revisão | booleano | não |
| IsOwner | contexto, sem efeito sobre a revisão | booleano | não |
| IsBot | contexto, sem efeito sobre a revisão | booleano | não |
| Deleted | contexto, sem efeito sobre a revisão | booleano | não |
| Updated | contexto, sem efeito sobre a revisão | data e hora | não |
11Papéis privilegiados · Administradores e papéis personalizados #sec_26a1dabe
slack.privileged-roles.admins:collect · revisão 3 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Proprietários, administradores e papéis personalizados. Chave de linha: UserId | RoleType | Scope (Scope vazio para is_admin e is_owner).
Métodos reservados para organizações Slack Enterprise: eles exigem um token de aplicação instalado na organização por um de seus proprietários ou administradores.
Chamadas
- GET users.list (is_admin, is_owner
- profile.email com users:read.email)
- GET admin.roles.listAssignments
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | users:read e users:read.email |
| Direito | requerida | admin.roles:read |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AssignmentKey | chave do objeto | texto | sim |
| UserId | contexto, sem efeito sobre a revisão | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | sim |
| RealName | contexto, sem efeito sobre a revisão | texto | não |
| exibido para reconhecer o objeto | texto | não | |
| RoleName | exibido para reconhecer o objeto | texto | não |
| RoleType | contexto, sem efeito sobre a revisão | texto | sim |
| Scope | contexto, sem efeito sobre a revisão | texto | não |
12Aplicações de terceiros · Aplicações instaladas #sec_6cfa3904
slack.apps.installed-apps:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Aplicações aprovadas no workspace ou organização, e suas portadas
Métodos reservados para organizações Slack Enterprise: eles exigem um token de aplicação instalado na organização por um de seus proprietários ou administradores.
Chamadas
- GET admin.apps.approved.list
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | admin.apps:read |
| Afiliação | requerida | o identificador pertence ao workspace Slack da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AppId | chave do objeto | texto | sim |
| AppName | exibido para reconhecer o objeto | texto | sim |
| Publisher | contexto, sem efeito sobre a revisão | texto | não |
| InstalledByUserId | contexto, sem efeito sobre a revisão | texto | não |
| InstalledOn | contexto, sem efeito sobre a revisão | data e hora | não |
| Scopes | contexto, sem efeito sobre a revisão | texto | não |
| IsDirectoryApproved | contexto, sem efeito sobre a revisão | booleano | não |
13Grupos de utilizadores · Membros do grupo de utilizadores #sec_cff1c96d
slack.groups.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Membros de um grupo de utilizadores. Chave da linha : UserGroupId | UserId.
Chamadas
- GET usergroups.users.list
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | necessário | usergroups:read |
| Membria | necessário | o identificador pertence ao espaço de trabalho Slack da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura : verificações de menos de 24 h ; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| UserGroupId | contexto, sem efeito na revisão | texto | sim |
| UserGroupName | contexto, sem efeito na revisão | texto | não |
| UserId | contexto, sem efeito na revisão | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não |
14Grupos de utilizadores #sec_6b350c1e
slack.groups.user-groups:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via slack.web-api.reviewit.app-token
Grupos de utilizadores, seu identificador @ e número de membros
Chamadas
- GET usergroups.list
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | necessário | usergroups:read |
| Membria | necessário | o identificador pertence ao espaço de trabalho Slack da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://slack.com/api responde
Frescura : verificações de menos de 24 h ; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserGroupId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Handle | exibido para reconhecer o objeto | texto | não |
| Description | contexto, sem efeito na revisão | texto | não |
| DateCreate | contexto, sem efeito na revisão | data e hora | não |
| DateDelete | contexto, sem efeito na revisão | data e hora | não |
| UserCount | contexto, sem efeito na revisão | inteiro | não |
15Para ir além #sec_a28ee5aa
- Compreender uma ligação de recolha
- Referência dos direitos por recurso
- Ler um veredicto