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, consulteMétodos de autenticación.
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
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 Quickstarten el sitio web de Slack. -
Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar integraciones en la consola.
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
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.
-
Ve al panel de la API de Slack
en el sitio web de Slack y selecciona Crear nueva aplicación. -
Selecciona Desde cero.
-
Introduce un nombre de aplicación y selecciona tu espacio de trabajo de Slack. Seleccione Crear una aplicación.
-
En la barra lateral izquierda, selecciona OAuth y permisos.
-
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/oauthcallbackSelecciona Añadir y, a continuación, selecciona Guardar URL.
-
En Ámbitos, añade los ámbitos del token de bot que requiera tu integración. Para conocer los ámbitos recomendados, consulte. Ámbitos recomendados
-
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
-
-
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.
| 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 ystars: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
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.
-
En la consola Amazon Quick, selecciona Connectors.
-
En la pestaña Disponible, busca Slack y selecciona Conectar.
-
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.
-
En la consola Amazon Quick, selecciona Connectors.
-
Selecciona la pestaña Crear para tu equipo.
-
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.
-
Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.
-
En Tipo de conexión, elija Red pública.
-
Para la configuración de OAuth, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.
-
Para la aplicación OAuth predeterminada:
No se necesitan credenciales adicionales. Elija Siguiente para continuar.
-
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.
-
-
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).
-
-
-
Elija Siguiente.
-
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.
-
En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.
-
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.
-
Elija Publicar.
Acciones disponibles
Tras configurar el conector, estarán disponibles las siguientes acciones.
| 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, consulteAdministrar las integraciones existentes.
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.
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.
-
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.
