Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Integración con Slack
Con el conector de acción de Slack, puedes acceder a la plataforma de Slack directamente en Amazon Quick a través de un lenguaje natural. Puedes enviar mensajes, gestionar canales, buscar contenido e interactuar con usuarios y grupos de usuarios sin salir de Amazon Quick.
Amazon Quick admite varios métodos de autenticación para Slack. Elige el método que mejor se adapte a los requisitos de seguridad de tu organización.
+ Aplicación **OAuth predeterminada: utiliza una aplicación** OAuth AWS gestionada. No se necesitan credenciales adicionales. Te autenticas directamente con tu espacio de trabajo de Slack.
+ Aplicación **OAuth personalizada: utiliza una aplicación de** Slack gestionada por el cliente. Esta opción le da a tu organización un control total sobre la configuración de OAuth.
+ Token **de portador: utiliza un token** de bot de Slack para la autenticación. Este método es adecuado para el acceso a un espacio de trabajo a nivel de bot.
Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulte[Métodos de autenticación](quick-action-auth.md).
## Antes de empezar
Asegúrese de disponer de lo siguiente antes de configurar la integración.
+ Un espacio de trabajo de Slack con acceso a los canales y datos que quieras usar.
+ Para una **aplicación OAuth personalizada**: accede al [panel de la API de Slack](https://api.slack.com/apps) en el sitio web de Slack para crear una aplicación.
+ Para **Bearer Token: un token** de bot (empieza por`xoxb-`) de una aplicación de Slack. Para obtener más información, consulta la [configuración de la aplicación Quickstart](https://docs.slack.dev/app-management/quickstart-app-settings) en el sitio web de Slack.
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).
## Configuración de Slack
Si utilizas la autenticación **por defecto de la aplicación OAuth**, omite esta sección y ve a. [Configuración del conector en Amazon Quick](#slack-quicksuite-setup)
Para la autenticación personalizada de una aplicación OAuth o un token de portador, sigue los pasos correspondientes en Slack antes de configurar Amazon Quick.
### Crea una aplicación de Slack para una aplicación OAuth personalizada o un token portador
Crea una aplicación de Slack para obtener las credenciales de cliente o el token de bot que necesitas para Amazon Quick.
1. Ve al [panel de la API de Slack](https://api.slack.com/apps) en el sitio web de Slack y selecciona **Crear** nueva aplicación.
1. Selecciona **Desde** cero.
1. Introduce un **nombre de aplicación** y selecciona tu espacio de trabajo de Slack. Seleccione **Crear una aplicación**.
1. En la barra lateral izquierda, selecciona **OAuth** y permisos.
1. En **URL de redireccionamiento**, selecciona **Añadir nueva URL de redireccionamiento e introduce la URL** de Amazon Quick callback: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
Selecciona **Añadir y, a** continuación, selecciona **Guardar** URL.
1. En **Ámbitos, añade los ámbitos** del token de bot que requiera tu integración. Para conocer los ámbitos recomendados, consulte. [Ámbitos recomendados](#slack-oauth-scopes)
1. **En la barra lateral izquierda, selecciona Información básica.** En **Credenciales de la aplicación**, registre los siguientes valores:
+ **ID de cliente**
+ **Secreto del cliente**
1. Para **Bearer Token**: instala la aplicación en tu espacio de trabajo desde la página de **OAuth y permisos**. Tras la instalación, copia el **token OAuth del usuario bot** (empieza por). `xoxb-`
### Ámbitos recomendados
Cuando te conectas a Slack, se solicitan los siguientes ámbitos. Cuando crees una aplicación de Slack personalizada, añade estos ámbitos en la página de **OAuth** y permisos. **En el caso de una aplicación OAuth personalizada, agrégalas como ámbitos de token de usuario.** **En el caso de Bearer Token, agrégalos como Bot Token Scopes.**
**Ámbitos recomendados por Slack**
| Alcance | Description (Descripción) |
| --- | --- |
| calls:read | Lee la información de las llamadas. |
| calls:write | Crea y gestiona las llamadas. |
| channels:history | Lee el historial de mensajes en los canales públicos. |
| channels:read | Lee información sobre los canales públicos. |
| channels:write | Administra los canales públicos. |
| chat:write | Envía mensajes a canales y conversaciones. |
| dnd:read | Lee la configuración de No molestar. |
| dnd:write | Actualiza la configuración de No molestar. |
| emoji:read | Lee emojis personalizados. |
| files:read | Lee los archivos compartidos en los canales. |
| files:write | Carga y administra archivos. |
| groups:history | Lee el historial de mensajes en los canales privados. |
| groups:read | Lee información sobre los canales privados. |
| groups:write | Administra los canales privados. |
| im:history | Lee el historial de mensajes en los mensajes directos. |
| im:read | Lee información sobre los mensajes directos. |
| im:write | Inicia los mensajes directos. |
| links:read | Lee las vistas previas de los enlaces. |
| links:write | Administra las vistas previas de los enlaces. |
| mpim:history | Lee el historial de mensajes en los mensajes directos grupales. |
| mpim:read | Lee información sobre los mensajes directos grupales. |
| mpim:write | Inicia los mensajes directos grupales. |
| pins:read | Lee los mensajes anclados. |
| pins:write | Fija y desfija los mensajes. |
| reactions:read | Lee las reacciones de los emojis en los mensajes. |
| reactions:write | Añade y elimina las reacciones de los emojis. |
| reminders:read | Lee los recordatorios. |
| reminders:write | Crea recordatorios. |
| remote\_files:read | Lee archivos remotos. |
| remote\_files:share | Comparte archivos remotos. |
| search:read | Busca mensajes y archivos. |
| stars:read | Lee los elementos destacados. |
| stars:write | Objetos con estrellas y desestrellas. |
| team:read | Lee la información del espacio de trabajo. |
| usergroups:read | Lee la información del grupo de usuarios. |
| usergroups:write | Administra los grupos de usuarios. |
| users:read | Lee la información del usuario. |
| users:read.email | Lee las direcciones de correo electrónico de los usuarios. |
| users:write | Actualiza la información del usuario. |
| users.profile:read | Lee la información del perfil del usuario. |
| users.profile:write | Actualiza la información del perfil de usuario. |
**nota**
No todos los ámbitos están disponibles tanto para los ámbitos del token de usuario como para los ámbitos del token de bot. Algunos ámbitos, como `search:read` y`stars:read`, solo están disponibles como ámbitos de token de usuario. Al configurar los ámbitos para la autenticación por token de portador, verifica la disponibilidad del alcance en la referencia de [ámbitos de la API de Slack en el sitio web de Slack](https://api.slack.com/scopes).
## Configuración del conector en Amazon Quick
### Conectarse desde la pestaña Disponible
Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña **Disponible** sin necesidad de realizar ninguna configuración adicional.
1. En la consola Amazon Quick, selecciona **Connectors**.
1. En la pestaña **Disponible**, busca **Slack** y selecciona **Conectar**.
1. Completa el flujo de inicio de sesión de Slack y concede los permisos solicitados.
Para configurar un conector con una aplicación OAuth personalizada o un token de portador, usa la pestaña **Crear para tu equipo**, tal y como se describe a continuación.
### Crea desde la pestaña Crear para tu equipo
Tras completar cualquier configuración de Slack requerida, crea el conector en Amazon Quick.
1. En la consola Amazon Quick, selecciona **Connectors**.
1. Selecciona la pestaña **Crear para tu equipo**.
1. Busca y elige **Slack**.
**nota**
Si ya existe un conector de Slack, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija **No, crear nuevo**.
1. Introduzca un **nombre** para el conector. Si lo desea, elija **\+ Añadir descripción** para añadir una descripción.
1. En **Tipo de conexión**, elija **Red pública**.
1. Para **la configuración de OAuth**, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.
1. Para la aplicación **OAuth predeterminada**:
No se necesitan credenciales adicionales. Elija **Siguiente** para continuar.
1. Para la **aplicación OAuth personalizada**, configura los siguientes campos:
+ **URL base** (opcional): la URL base de la API de Slack. Ejemplo: `https://slack.com/api`
+ **ID de cliente**: el ID de cliente de tu aplicación de Slack.
+ **Secreto de cliente**: el secreto de cliente de tu aplicación de Slack.
+ **URL del token**: el punto final del token. Ejemplo: `https://slack.com/api/oauth.v2.access`
+ **URL de autorización**: el punto final de autorización. Ejemplo: `https://slack.com/oauth/v2/authorize`
+ **URL de redireccionamiento**: Pre-filled con la URL de devolución de llamada rápida de Amazon.
1. Para **Bearer Token**, configure los siguientes campos:
+ **URL base** (opcional): la URL base de la API de Slack. Ejemplo: `https://slack.com/api`
+ **Token de bot**: tu token de bot de Slack (empieza `xoxb-` por).
1. Elija **Siguiente**.
1. Si seleccionas la aplicación **OAuth predeterminada o la aplicación OAuth** **personalizada, se abrirá una ventana de autorización** de Slack. **Revisa los permisos solicitados, selecciona tu espacio de trabajo y selecciona Permitir.**
1. **En la página de revisión, revise las acciones disponibles para el conector.** Elija **Siguiente**.
1. En la página de **publicación**, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.
1. Elija **Publicar**.
## Acciones disponibles
Tras configurar el conector, estarán disponibles las siguientes acciones.
**Acciones disponibles en Slack**
| Categoría | Action | Description (Descripción) |
| --- | --- | --- |
| Mensajes | Mensaje de publicación de chat | Publica un mensaje en un canal, mensaje directo o grupo privado. |
| Mensajes | Envíame un mensaje | Envía un mensaje de acción en tercera persona a un canal. |
| Mensajes | Obtenga el enlace permanente del mensaje | Recupera la URL de un enlace permanente para un mensaje específico. |
| Canales | Conversaciones: creación | Crea un canal público o privado. |
| Canales | Historial de conversaciones | Recupera el historial de mensajes de un canal. Devuelve únicamente los mensajes de la cronología principal, no las respuestas encadenadas. |
| Canales | Conversaciones y respuestas | Recupera las respuestas encadenadas a un mensaje principal específico. |
| Canales | Invitación a conversaciones | Invita a los usuarios a un canal existente. |
| Canales | Unirse a las conversaciones | Se une a un canal existente. |
| Canales | Las conversaciones comienzan | Elimina a un usuario de un canal. |
| Canales | Las conversaciones se van | Sale de un canal. |
| Canales | Conversaciones: miembros | Muestra los ID de los miembros de un canal. |
| Canales | Conversaciones abiertas | Abre o reanuda un mensaje directo o un mensaje directo para varias personas. |
| Canales | Conversaciones: establece un tema | Establece o actualiza el tema de un canal. |
| Canales | Conseguir una conversación | Recupera los metadatos de un canal por ID. |
| Canales | Enumere los canales | Muestra los canales disponibles para el usuario. |
| Canales | Enumere las conversaciones del usuario | Muestra los canales y los mensajes directos a los que puede acceder un usuario. |
| Reacciones | Crear reacción | Añade una reacción de emoji a un mensaje. |
| Reacciones | Eliminar reacción | Elimina la reacción de un emoji de un mensaje. |
| Reacciones | Enumere las reacciones | Enumera las reacciones de un mensaje, archivo o comentario de un archivo. |
| Archivos | Cargue o cree un archivo | Carga archivos o contenido multimedia a canales o hilos. |
| Archivos | Cargar a una URL externa | Añade una referencia a un archivo externo para compartirlo en Slack. |
| Archivos | Descargar archivo | Descarga un archivo compartido en Slack. |
| Archivos | Información de archivos | Recupera los metadatos y los comentarios de un archivo. |
| Archivos | Lista de archivos | Muestra los archivos de un espacio de trabajo con filtros opcionales. |
| Search | Buscar en todos | Busca mensajes y archivos en todo el espacio de trabajo. |
| Search | Busca mensajes | Busca mensajes con rangos de fechas y filtros. |
| Search | Busca canales | Busca los canales por nombre, tema o propósito. |
| Search | Busca usuarios | Busca usuarios por correo electrónico, nombre o nombre para mostrar. |
| Search | Contexto de búsqueda | Busca en mensajes, archivos, canales y usuarios. Con la IA de Slack, admite la búsqueda semántica en los espacios de trabajo. |
| Search | Obtenga la configuración de búsqueda | Comprueba si la búsqueda semántica está disponible en el espacio de trabajo. |
| Users | Obtención de detalles del usuario | Recupera la información de un usuario por ID. |
| Users | Obtenga el perfil de usuario | Recupera la información del perfil de un usuario. |
| Users | Conjunto de perfiles de usuario | Actualiza los campos del perfil de un usuario. |
| Users | Lista de usuarios | Muestra todos los usuarios del espacio de trabajo. |
| Grupos de usuarios | Creación de grupos de usuarios | Crea un nuevo grupo de usuarios. |
| Grupos de usuarios | Lista de grupos de usuarios | Muestra los grupos de usuarios del espacio de trabajo. |
| Grupos de usuarios | Grupos de usuarios: actualizaciones de usuarios | Sustituye a todos los miembros de un grupo de usuarios. |
| Recordatorios | Recordatorios: Agregar | Crea un recordatorio con el texto y la hora especificados. |
| Espacio de trabajo | Obtén el equipo | Recupera metadatos sobre el espacio de trabajo de Slack. |
**nota**
Las acciones que puedes usar dependen de los ámbitos configurados para tu aplicación de Slack y de los canales a los que pueda acceder el usuario autenticado.
## Administración y solución de problemas
Para editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).
### Problemas de autenticación
+ **Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada)**[: verifica que tu espacio de trabajo de Slack esté activo y que puedas iniciar sesión directamente en el sitio web de Slack.](https://slack.com) En el caso de la aplicación OAuth personalizada, confirma que la URL de redireccionamiento de tu aplicación de Slack coincide con la URL de devolución rápida de Amazon.
+ **Credenciales de cliente no válidas (aplicación OAuth personalizada)**: comprueba que el ID y el secreto del cliente coincidan con los valores de la sección de información básica de la aplicación de Slack.
+ **Token de portador rechazado**: verifica que tu token de bot esté activo y comience por. `xoxb-` Los tokens se pueden revocar desde el panel de la API de Slack.
+ **Permisos insuficientes**: verifica que los ámbitos configurados para tu aplicación de Slack incluyan los permisos necesarios para las acciones que quieres usar. Consulte [Ámbitos recomendados](#slack-oauth-scopes).
+ **No se encuentra el canal o no está en el canal**: comprueba que el bot se haya añadido al canal. Invita al bot al canal antes de intentar publicar mensajes o leer el historial.