Requisitos previos de Slack

Introducción

Estos son los requisitos previos para utilizar el conector Slack. Primero crea una aplicación de Slack en el espacio de trabajo seleccionado y luego agregar ámbitos a la aplicación creada.

Estos pasos incluyen estas instrucciones:

• Obtener un token OAuth (requerido cuando se utiliza Autenticación basada en token en la conexión).
• Configurar OAuth de tres vías (requerido cuando se utiliza Concesión de código de autorización en la conexión)

Crear una aplicación de Slack

Siga estos pasos para crear una aplicación de Slack en el espacio de trabajo seleccionado:

1. En el sitio web de la API de Slack, haga clic en Crear una aplicación y luego haga clic en Desde cero.

2. Proporcione un nombre para su aplicación y seleccione un espacio de trabajo, luego haga clic en Crear aplicación:

   

3. Vaya a la página Webhooks entrantes (a la que se accede desde el menú Funciones) y cambie la opción Activar webhooks entrantes a Activado, luego haga clic en Agregar nuevo webhook al espacio de trabajo:

   

4. En el menú, selecciona el canal de Slack donde deseas publicar mensajes y haz clic en Permitir:

   

   Nota

   Es posible que se requiera la aprobación de alguien que administre aplicaciones en su espacio de trabajo. Use el botón Solicitar para agregar un nuevo webhook para enviar una solicitud de aprobación.

Agregar ámbitos

Siga estos pasos para agregar ámbitos a la aplicación creada:

1. En la página OAuth y permisos (a la que se accede desde el menú Funciones), vaya a la sección Ámbitos y haga clic en Agregar un ámbito OAuth en la sección Ámbitos de token de bot o Ámbitos de token de usuario (según el tipo de token que esté utilizando):

   

2. Agregue estos ámbitos según las actividades que se utilizarán:

   Actividad	Ámbito
   Buscar	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Publicación	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write
   Chat	conversations.connect:manage conversations.connect:read
   Obtener	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write team.billing:read team.preferences:read team:read workflow.steps:execute
   Archivos	files:read files:write remote_files:read remote_files:share remote_files:write
   Conversaciones	conversations.connect:manage conversations.connect:read conversations.connect:write
   Usuarios	users.profile:read users:read users:read.email users:write

Obtener un token OAuth

Si está autenticando la conexión con un token de bot o token de usuario, siga estos pasos:

1. Vaya a la página OAuth y permisos a la que se accede desde el sitio web de la API de Slack Sección Características.

2. Para obtener un token de bot, copie el Bot User OAuth Token (con el prefijo xoxb) en OAuth Tokens.

   Para obtener un token de usuario, copie el Token OAuth del usuario (con el prefijo xoxp) en Tokens OAuth:

   

   Nota

   El Token OAuth de usuario solo es visible cuando se han agregado Ámbitos de token de usuario a la aplicación.

Configurar OAuth de tres vías

Esta sección cubre los pasos para autenticar la conexión para utilizar la autenticación OAuth 2.0 de 3 patas (3LO) con una aplicación privada configurada en la Management Console Registros de aplicaciones página.

Las aplicaciones privadas son aplicaciones que configuras para la instancia de Slack (descritas en Crear una aplicación de Slack) y luego regístrese en la Management Console Registros de aplicaciones página con estos valores de la aplicación Slack:

• ID de cliente y secreto de cliente
• Ámbitos
• URL de autorización
• URL del token de acceso
• Actualizar URL del token

URL de redireccionamiento

Al configurar su aplicación en Slack, asegúrese de que la URL de redireccionamiento esté configurada en una de las siguientes URLs (según la región de su organización):

Instrucciones

Estas son las instrucciones para obtener los valores requeridos para el registro de la aplicación:

1. Configurar una aplicación OAuth para la instancia de Slack.

2. Navegue hasta su aplicación en el sitio web de la API de Slack.

3. Para obtener el ID y el secreto del cliente para el registro de la aplicación, vaya a la página Información básica de la aplicación Slack. Los valores se encuentran en la sección Credenciales de la aplicación:

   

4. Para obtener los Ámbitos para el registro de la aplicación, vaya a la página OAuth & Permissions de su aplicación Slack, navegue hasta la sección Ámbitos y obtenga los ámbitos utilizados para la aplicación. En la configuración del registro de la aplicación, ingrese cada uno de los ámbitos de la aplicación en su formato de código, por ejemplo, read:me.

5. Establezca la URL de autenticación de la aplicación como https://slack.com/oauth/v2/authorize.

6. Establezca la URL del token de acceso de la aplicación como https://slack.com/api/oauth.v2.access.

7. Establezca la URL del token de actualización de la aplicación como https://slack.com/api/oauth.v2.access.

8. Vaya a Opciones avanzadas.

   En la pestañaSolicitud de token en Parámetros, ingrese Accept-Encoding como la Clave y */* como Valor. Luego, seleccione Encabezado de solicitud en el menú Enviar.

   Nota

   La URL del token de acceso se rellena previamente con el valor proporcionado en el paso 6 y no se debe cambiar.

9. En la pestañaActualizar solicitud en Parámetros, ingrese estos pares clave-valor:

   • Para el primer par clave-valor, ingrese Accept-Encoding como la Clave y entrar */* como Valor. Luego, seleccione Encabezado de solicitud en el menú Enviar.

   • Para el segundo par clave-valor, ingrese grant_type como la Clave y entrar refresh_token como Valor. Luego, seleccione URL de solicitud en el menú Enviar.

     Nota

     La URL del token de actualización se rellena previamente con el valor proporcionado en el paso 7 y no se debe cambiar.

Una vez que la aplicación OAuth de 3 patas se registra en Registros de aplicaciones La página está disponible para ser seleccionada en el menú Aplicación OAuth en Aplicaciones privadas en la Conexión Slack.