La integración de Slack de Dialogflow facilita la creación de tus propios bots y apps de Slack y entrenarlos para que entiendan el lenguaje natural.
Limitaciones
Solo los idioma predeterminado del agente es compatible con esta integración.
Configura Slack
A fin de configurar la integración de Slack para tu agente, necesitarás lo siguiente:
- Una cuenta de Slack
- Un equipo de Slack
Crear una aplicación de Slack
- Navega a la Consola del desarrollador de Slack.
- Ingresa un nombre para tu aplicación.
- Elige un Team (Equipo) al que te gustaría que se asocie la aplicación.
- Haz clic en el botón Create App (Crear app).
Agrega un usuario bot
- Haz clic en OAuth y permisos en el menú de la izquierda.
- Ve a la sección Alcances y asegúrate de que los siguientes alcances de OAuth se encuentren en la sección de alcances de token de bot
.
- Haz clic en Página principal de la aplicación en el menú de la izquierda.
- Habilita Siempre mostrar mi bot como en línea y edita el Nombre de distribución de la app en los siguientes casos: necesario (esto es lo que verán los usuarios sobre tu bot)
Habilita la integración en Dialogflow
En la consola para desarrolladores de Slack, haz clic en Información básica en el lado izquierdo. y desplázate hacia abajo hasta la sección App Credentials. Toma nota de las Client ID, Client Secret y Verification Token.
Vincula Slack a Dialogflow
- En Dialogflow, ve a Integraciones en el menú de la izquierda.
- Haz clic en el mosaico Slack.
- Ingresa los valores relacionados en los siguientes campos:
- Client ID (ID de cliente)
- Client Secret (Secreto del cliente)
- Verification Token (Token de verificación)
- Haz clic en Start (Iniciar).
Continúa con la configuración de Slack
Ahora que configuraste Slack y Dialogflow, habilitarás OAuth, Event URLs de solicitudes (proporcionadas por Dialogflow) y suscripciones a eventos.
Agrega la URL de OAuth
- Copia la URL de OAuth de la página de configuración de Slack de Dialogflow.
- Ve a la consola para desarrolladores de Slack y haz clic en OAuth & Permisos en menú de la izquierda
- Haz clic en el botón Add a new Redirect URL (Agregar una URL de redireccionamiento nueva) y pega la URL de OAuth.
- Haz clic en Add (Agregar).
- Haz clic en el botón Guardar URL.
Agrega la URL de solicitud de evento y habilita las suscripciones a eventos
- Copia la URL de solicitud de evento de la página de configuración de Slack de Dialogflow.
- Ve a la consola para desarrolladores de Slack y haz clic en Event Subscriptions (Suscripciones a eventos) en el menú de la izquierda
- Haz clic en el interruptor para habilitar la opción Eventos y pega la URL de la suscripción al evento en
al campo Request URL
Después de unos momentos, deberías ver el mensaje "Verificado" en color verde. arriba de la URL de la solicitud . En subscribe to Bot Events , haz clic en Add Bot User Event. botón
Esto revelará el campo de texto y la lista de eventos. Puedes ingresar términos para buscar eventos a los que deseas que responda tu bot. Esta es una lista de eventos que sugerimos que agregues:Nombre del evento Descripción del evento message.im Se publicó un mensaje en un canal de mensajes directos message.groups Se publicó un mensaje en un canal privado message.channels Se publicó un mensaje en un canal im_created Se creó un mensaje directo. En la sección Suscribirse a eventos en nombre de usuarios haz clic en el botónAgregar evento del lugar de trabajo para agregar el evento im_created, luego presionaGuardar cambios. Cuando termines de actualizar estos parámetros de configuración, haz clic en el botón Guardar cambios. en la parte inferior de la página.
Agrega tu bot de Slack a un equipo
- En la consola para desarrolladores de Slack, haz clic en Manage Distribution (Administrar distribución) a la izquierda. menú
- En la sección Share Your App with Your Workplace, haz clic en el botón Add to
Botón de Slack
- En la siguiente página, haz clic en el botón Authorize (Autorizar) para agregar el agente.
Realiza pruebas
Puedes probar el agente sin crear un bot de Slack público. Para ello, ve a Página Integraciones de tu agente y haz clic en el interruptor del mosaico Slack. En la ventana emergente, haz clic en el botón Test In Slack (Probar en Slack).
Se te solicitará que accedas a Slack. Una vez que hayas accedido, navega hasta la instancia y busca el usuario bot llamado @dialogflow-bot. Puedes enviarle un mensaje directo al agente para probarlo o agregarlo a canales en tu instancia.
Eventos
Esta integración invoca los siguientes eventos:
Evento | Descripción |
---|---|
SLACK_WELCOME |
Se activa cuando un usuario inicia una conversación con tu bot de Slack. |
Mensajes de respuesta enriquecida
Se admiten los siguientes mensajes de respuesta enriquecida.
Respuestas de imagen
Formatos y tamaños admitidos:
- GIF
- jpeg
- png
- bmp
Respuestas con tarjeta
No hay campos obligatorios para las tarjetas en Slack; se puede usar cualquier combinación de elementos.
Se admiten botones con una URL y con una devolución de texto. Los botones con una URL se muestran como hipervínculos.
Respuestas rápidas
Las respuestas rápidas son compatibles con las integraciones con un clic de Slack y corresponden a una versión de texto de los botones interactivos de Slack.
Respuestas con carga útil personalizada
Texto con formato en la integración con un clic de Slack
Los bots de Slack pueden enviar texto con formato, como se muestra en el siguiente ejemplo:
{ "slack": { "text": "This is an example of *bold*, _italic_, and `code`." } }