Slack

La integración de Slack de Dialogflow te permite crear tus propios bots y apps de Slack con facilidad. y entrenarlos para que entiendan el lenguaje natural.

Nota: Cuando se usa una integración de terceros, las solicitudes y los datos del usuario final se envían a Google y al tercero. Las Condiciones del Servicio, el ANS, los precios y las cuotas de tu edición de agente se aplican a la administración de estas solicitudes por parte de Google. Las Condiciones del Servicio, el ANS, los precios y las cuotas del tercero se aplican a la administración de estas solicitudes por parte del tercero.

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

1. Navega a la Consola del desarrollador de Slack.
2. Ingresa un nombre para tu aplicación.
3. Elige un Team (Equipo) al que te gustaría que se asocie la aplicación.
4. Haz clic en el botón Create App (Crear app).

Agrega un usuario bot

1. Haz clic en OAuth y permisos en el menú de la izquierda.
2. 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 .
3. Haz clic en Página principal de la aplicación en el menú de la izquierda.
4. 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

1. En Dialogflow, ve a Integraciones en el menú de la izquierda.
2. Haz clic en el mosaico Slack.
3. Ingresa los valores relacionados en los siguientes campos:
   1. Client ID (ID de cliente)
   2. Client Secret (Secreto del cliente)
   3. Verification Token (Token de verificación)
4. Haz clic en Start (Iniciar).

Continúa con la configuración de Slack

Ahora que configuraste Slack y Dialogflow, debes habilitar OAuth, las URLs de solicitudes de eventos (proporcionadas por Dialogflow) y las suscripciones a eventos.

Agrega la URL de OAuth

1. Copia la URL de OAuth de la página de configuración de Slack de Dialogflow.

Nota: Si tu app de Slack es una app clásica de Slack y aún no la has actualizado, deberás hacer clic en Mostrar las URL del flujo de trabajo heredado de Slack en la página de configuración de Slack de Dialogflow y, luego, copia la URL de OAuth. Consulta la Guía de inicio rápido: diferencias entre las apps antiguas y nuevas de Slack para obtener más información.

1. Ve a la consola para desarrolladores de Slack y haz clic en OAuth & Permisos en menú de la izquierda
2. Haz clic en el botón Add a new Redirect URL (Agregar una URL de redireccionamiento nueva) y pega la URL de OAuth.
3. Haz clic en Add (Agregar).
4. Haz clic en el botón Guardar URL.

Agrega la URL de solicitud de evento y habilita las suscripciones a eventos

1. Copia la URL de solicitud de evento de la página de configuración de Slack de Dialogflow.
2. Ve a la consola para desarrolladores de Slack y haz clic en Event Subscriptions (Suscripciones a eventos) en el menú de la izquierda.
3. 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" de color verde. arriba de la URL de la solicitud .

4. En Suscribirse a eventos de bot, haz clic en el botón Agregar evento de usuario de bot.
   
   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. Aquí encontrarás una lista de los 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.

   

5. 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

1. En la consola para desarrolladores de Slack, haz clic en Manage Distribution (Administrar distribución) en el menú de la izquierda.
2. En la sección Share Your App with Your Workplace (Compartir tu app con tu lugar de trabajo), haz clic en el botón Add to Slack (Agregar a Slack).
3. 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 hacerlo, ve a la 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 encuentra el usuario bot llamado @dialogflow-bot. Puedes enviarle un mensaje directo al agente para probarlo o agregarlo a canales en tu instancia.

Nota: Para cambiar el nombre del agente o agregar un logotipo, deberás hacer que el bot sea público.

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`."
  }
}