Requisitos previos para el conector de Slack en Jitterbit Integration Studio

Introducción

Estos son los requisitos previos para usar el conector de Slack. Primero debes crear una aplicación de Slack en el espacio de trabajo seleccionado y luego agregar permisos a la aplicación creada.

Estos pasos incluyen las siguientes instrucciones:

• Obtener un token OAuth (requerido al usar Autenticación basada en token en la conexión).
• Configurar OAuth de 3 pasos (requerido al usar Código de autorización en la conexión).

Crear una aplicación de Slack

Sigue 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, haz clic en Crear una aplicación y luego en Desde cero.

2. Proporciona un nombre para tu aplicación y selecciona un espacio de trabajo, luego haz clic en Crear aplicación:

   

3. Ve a la página de Webhooks entrantes (accedida desde el menú Características) y activa la opción Activar Webhooks entrantes en On, luego haz clic en Agregar nuevo Webhook al espacio de trabajo:

   

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

   

   Nota

   Puede ser necesario obtener la aprobación de alguien que administre aplicaciones en tu espacio de trabajo. Usa el botón Solicitar agregar nuevo Webhook para enviar una solicitud de aprobación.

Agregar permisos

Sigue estos pasos para agregar permisos a la aplicación creada:

1. En la página de OAuth y permisos (accedida desde el menú Características), ve a la sección de Permisos y haz clic en Agregar un permiso OAuth en la sección de Permisos de token de bot o Permisos de token de usuario (dependiendo del tipo de token que estés utilizando):

   

2. Agrega estos alcances dependiendo de las actividades a utilizar:

   Actividad	Alcance
   Buscar	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Publicar	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ás autenticando la conexión con un token de bot o token de usuario, sigue estos pasos:

1. Ve a la página de OAuth y Permisos accesible desde la sección de Características del sitio web de la API de Slack.

2. Para obtener un token de bot, copia el Token OAuth de Usuario de Bot (precedido por xoxb) bajo Tokens OAuth.

   Para obtener un token de usuario, copia el Token OAuth de Usuario (precedido por xoxp) bajo Tokens OAuth:

   

   Nota

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

Configurar OAuth de 3 pasos

Esta sección cubre los pasos para autenticar la conexión para usar la autenticación OAuth 2.0 de 3 pasos (3LO) con una aplicación privada configurada en la página de Registros de Aplicaciones de la Consola de Administración.

Las aplicaciones privadas son aplicaciones que configuras para la instancia de Slack (descrito en Crear una Aplicación de Slack) y luego registras en la página de Registros de Aplicaciones de la Consola de Administración con estos valores de la aplicación de Slack:

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

Redirect URL

Al configurar tu aplicación en Slack, asegúrate de que la URL de redirección esté establecida en una de las siguientes URLs (dependiendo de la región de tu organización):

Instructions

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

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

2. Navega a tu aplicación en el sitio web de la API de Slack.

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

   

4. Para obtener los Alcances para el registro de la aplicación, ve a la página de OAuth y permisos de tu aplicación de Slack, navega a la sección de Alcances y obtén los alcances utilizados para la aplicación. En la configuración del registro de la aplicación, ingresa cada uno de los alcances de la aplicación en su formato de código, por ejemplo, read:me.

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

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

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

8. Ve a Opciones avanzadas.

   En la pestaña Solicitud de token bajo Parámetros, ingresa Accept-Encoding como la Clave y */* como el Valor. Luego selecciona Encabezado de solicitud en el menú Enviar en.

   Nota

   La URL del token de acceso se completa automáticamente con el valor proporcionado en el paso 6 y no debe ser cambiada.

9. En la pestaña Solicitud de actualización bajo Parámetros, ingresa estos pares clave-valor:

   • Para el primer par clave-valor, ingresa Accept-Encoding como la Clave e ingresa */* como el Valor. Luego selecciona Encabezado de solicitud en el menú Enviar en.

   • Para el segundo par clave-valor, ingresa grant_type como la Clave e ingresa refresh_token como el Valor. Luego selecciona URL de solicitud en el menú Enviar en.

     Nota

     La URL del token de actualización se completa automáticamente con el valor proporcionado en el paso 7 y no debe ser cambiada.

Una vez que la aplicación OAuth de 3 patas esté registrada en la página de Registros de aplicaciones, estará disponible para ser seleccionada en el menú Aplicación OAuth bajo Aplicaciones privadas en la conexión de Slack.