Contratos de recolección — Slack
01Cómo leer esta página #sec_487f6ca2
Cada recurso que REVIEWIT puede recolectar para Slack tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recolectado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.
- Llamadas: las solicitudes que REVIEWIT dirige al servicio recolectado, todas en lectura.
- Exigencias: cada una debe ser satisfecha. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no incluye, constatada por una llamada real en lectura), o la pertenencia del identificador al espacio de trabajo Slack de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la opción única, « una a elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N a elección entre M ».
- Condiciones de funcionamiento: lo que REVIEWIT constata antes de cada recolección, más allá de los requisitos.
- Frescura: la edad máxima de las verificaciones sobre las cuales el veredicto se basa, fijada por cada contrato (aquí: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real). REVIEWIT vuelve a hacer automáticamente dentro de este plazo las verificaciones que puede realizar (token obtenido, servicio que responde); « Verificar los derechos », en el menú de la conexión, los vuelve a hacer bajo demanda. Mientras la llamada real no se haya realizado, los derechos permanecen no constatados.
- Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.
El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recolecta puede ser alimentado por la importación de un informe (« Importar un informe »).
02Cómo REVIEWIT verifica los requisitos #sec_b6669f0d
El token Slack no incluye sus derechos: el contrato exige que sean constatados por una llamada real, en lectura. REVIEWIT aún no hace esta llamada para Slack: constata que el token está obtenido y que el servicio responde, pero no los derechos listados aquí. Los recursos se muestran « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_1058f591
Una vía indica qué token REVIEWIT obtiene para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama sobre la audiencia del token de su vía.
| Vía | Token emitido por | Audiencia del token | Autenticación del identificador |
|---|---|---|---|
| slack.web-api.reviewit.app-token | https://slack.com/api/oauth.v2.access | https://slack.com/api | token o secreto de API |
04Conversaciones · Canales Slack Connect #sec_6a07c744
slack.conversations.connect-channels:collect · revisión 3 del contrato, publicado el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Canales compartidos con una organización externa (Slack Connect)
Llamadas
- GET conversations.list (is_ext_shared)
- GET conversations.info
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | todas | channels:read y groups:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- un token está obtenido para el identificador
- el servicio https://slack.com/api responde
Frescura: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| ChannelId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| ConnectedTeamIds | contexto, sin efecto sobre la revisión | texto | no |
| ConnectedTeamNames | contexto, sin efecto sobre la revisión | texto | no |
| IsExtShared | contexto, sin efecto sobre la revisión | booleano | no |
| IsPendingExtShared | contexto, sin efecto sobre la revisión | booleano | no |
| NumMembers | contexto, sin efecto sobre la revisión | entero | no |
05Conversaciones · Miembros del canal #sec_b2cc14d6
slack.conversations.memberships:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Miembros de un canal: personas, bots y miembros externos (Slack Connect). Clave de fila: ChannelId | UserId.
Llamadas
- GET conversations.list?types=public_channel,private_channel
- GET conversations.members
- GET users.list (Handle, Email, IsBot, IsExternal
- profile.email con users:read.email)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | todas | channels:read y groups:read |
| Permiso | todas | users:read y users:read.email |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| ChannelId | contexto, sin efecto sobre la revisión | texto | sí |
| ChannelName | contexto, sin efecto sobre la revisión | texto | no |
| UserId | contexto, sin efecto sobre la revisión | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| IsBot | contexto, sin efecto sobre la revisión | booleano | no |
| IsExternal | contexto, sin efecto sobre la revisión | booleano | no |
06Conversaciones · Canales privados #sec_6fd090de
slack.conversations.private-channels:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Canales privados visibles para la aplicación
Llamadas
- GET conversations.list?types=private_channel
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | groups:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| ChannelId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Creator | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| IsArchived | contexto, sin efecto sobre la revisión | booleano | no |
| NumMembers | contexto, sin efecto sobre la revisión | entero | no |
| Topic | contexto, sin efecto sobre la revisión | texto | no |
| Purpose | contexto, sin efecto sobre la revisión | texto | no |
07Conversaciones · Canales públicos #sec_ad6b215b
slack.conversations.public-channels:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Canales públicos, su creador y su estado de archivado
Llamadas
- GET conversations.list?types=public_channel
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | channels:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| ChannelId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Creator | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| IsArchived | contexto, sin efecto sobre la revisión | booleano | no |
| NumMembers | contexto, sin efecto sobre la revisión | entero | no |
| Topic | contexto, sin efecto sobre la revisión | texto | no |
| Purpose | contexto, sin efecto sobre la revisión | texto | no |
08Directorio · Invitados #sec_e2730131
slack.directory.guests:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Invitados monocanal e invitados multicanal
Llamadas
- GET users.list (is_restricted, is_ultra_restricted
- profile.email con users:read.email)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | todas | users:read y users:read.email |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserId | clave del objeto | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | sí |
| RealName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | no | |
| GuestType | contexto, sin efecto sobre la revisión | texto | no |
| InvitedBy | contexto, sin efecto sobre la revisión | texto | no |
| ExpiresOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Deleted | contexto, sin efecto sobre la revisión | booleano | no |
09Directorio · Invitaciones pendientes #sec_ea68488c
slack.directory.pending-invitations:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Solicitudes de invitación enviadas para la aprobación de un administrador, pendientes o aprobadas
Métodos reservados para organizaciones Slack Enterprise: requieren un token de aplicación instalado en la organización por uno de sus propietarios o administradores.
Llamadas
- GET admin.inviteRequests.list
- GET admin.inviteRequests.approved.list
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | admin.invites:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser verificados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| InviteId | clave del objeto | texto | sí |
| mostrado para reconocer el objeto | texto | sí | |
| InvitedBy | contexto, sin efecto sobre la revisión | texto | no |
| InvitedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
| InviteType | contexto, sin efecto sobre la revisión | texto | no |
| Channels | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
10Directorio · Usuarios y bots #sec_5512c006
slack.directory.users:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Cuentas del espacio de trabajo: miembros, bots, cuentas desactivadas
Llamadas
- GET users.list (usuarios y bots
- profile.email con users:read.email)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | todas | users:read y users:read.email |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser verificados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserId | clave del objeto | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | sí |
| RealName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | no | |
| IsAdmin | contexto, sin efecto sobre la revisión | booleano | no |
| IsOwner | contexto, sin efecto sobre la revisión | booleano | no |
| IsBot | contexto, sin efecto sobre la revisión | booleano | no |
| Deleted | contexto, sin efecto sobre la revisión | booleano | no |
| Updated | contexto, sin efecto sobre la revisión | fecha y hora | no |
11Roles privilegiados · Administradores y roles personalizados #sec_26a1dabe
slack.privileged-roles.admins:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Propietarios, administradores y roles personalizados. Clave de fila: UserId | RoleType | Scope (Scope vacío para is_admin y is_owner).
Métodos reservados para organizaciones Slack Enterprise: requieren un token de aplicación instalado en la organización por uno de sus propietarios o administradores.
Llamadas
- GET users.list (is_admin, is_owner
- profile.email con users:read.email)
- GET admin.roles.listAssignments
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | todas | users:read y users:read.email |
| Permiso | requerida | admin.roles:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser verificados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AssignmentKey | clave del objeto | texto | sí |
| UserId | contexto, sin efecto sobre la revisión | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | sí |
| RealName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | no | |
| RoleName | mostrado para reconocer el objeto | texto | no |
| RoleType | contexto, sin efecto sobre la revisión | texto | sí |
| Scope | contexto, sin efecto sobre la revisión | texto | no |
12Aplicaciones de terceros · Aplicaciones instaladas #sec_6cfa3904
slack.apps.installed-apps:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Aplicaciones aprobadas en el espacio de trabajo o la organización, y sus alcances
Métodos reservados para organizaciones Slack Enterprise: requieren un token de aplicación instalado en la organización por uno de sus propietarios o administradores.
Llamadas
- GET admin.apps.approved.list
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | admin.apps:read |
| Pertenencia | requerida | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser verificados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AppId | clave del objeto | texto | sí |
| AppName | mostrado para reconocer el objeto | texto | sí |
| Publisher | contexto, sin efecto sobre la revisión | texto | no |
| InstalledByUserId | contexto, sin efecto sobre la revisión | texto | no |
| InstalledOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Scopes | contexto, sin efecto sobre la revisión | texto | no |
| IsDirectoryApproved | contexto, sin efecto sobre la revisión | booleano | no |
13Grupos de usuarios · Miembros del grupo de usuarios #sec_cff1c96d
slack.groups.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Miembros de un grupo de usuarios. Clave de fila: UserGroupId | UserId.
Llamadas
- GET usergroups.users.list
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | usergroups:read |
| Miembro | requerido | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones operativas
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser verificados mediante una llamada real.
Datos almacenados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| UserGroupId | contexto, sin efecto en la revisión | texto | sí |
| UserGroupName | contexto, sin efecto en la revisión | texto | no |
| UserId | contexto, sin efecto en la revisión | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no |
14Grupos de usuarios #sec_6b350c1e
slack.groups.user-groups:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía slack.web-api.reviewit.app-token
Grupos de usuarios, su identificador @ y su número de miembros
Llamadas
- GET usergroups.list
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | usergroups:read |
| Miembro | requerido | el identificador pertenece al espacio de trabajo Slack de la conexión |
Condiciones operativas
- se obtiene un token para el identificador
- el servicio https://slack.com/api responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser verificados mediante una llamada real.
Datos almacenados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserGroupId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Handle | mostrado para reconocer el objeto | texto | no |
| Description | contexto, sin efecto en la revisión | texto | no |
| DateCreate | contexto, sin efecto en la revisión | fecha y hora | no |
| DateDelete | contexto, sin efecto en la revisión | fecha y hora | no |
| UserCount | contexto, sin efecto en la revisión | entero | no |
15Para ir más allá #sec_a28ee5aa
- Comprender una conexión de recolección
- Referencia de permisos por recurso
- Leer un veredicto