Slack

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

Limitaciones

Esta integración solo admite el idioma predeterminado del agente.

Configura Slack

A fin de configurar la integración de Slack para tu agente, necesitarás lo siguiente:

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 Always Show My Bot as Online y, si es necesario, edita App Dispary Name (esta es la información que verán los usuarios para tu bot).

Habilita la integración en Dialogflow

En la consola para desarrolladores de Slack, haz clic en la opción Información básica del menú de la izquierda y desplázate hasta la sección App Credentials (Credenciales de la app). Toma nota del Client ID (ID de cliente), el Client Secret (Secreto del cliente) y el Verification Token (Token de verificación).

  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 URL 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.
  1. Ve a la consola del desarrollador de Slack y haz clic en OAuth y permisos (OAuth & Permissions) en el 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 del desarrollador de Slack y haz clic en Suscripciones a eventos (Event Subscriptions) en el menú de la izquierda.
  3. Haz clic en el interruptor para habilitar los eventos y pega la URL de la suscripción a evento en el campo Request URL(URL de solicitud).

    Después de unos minutos, deberías ver la palabra “Verified” (Verificada) en color verde encima del campo de la URL de solicitud.

  4. En Suscribirse a eventos de bot, haz clic en el botón Agregar evento de usuario bot.

    Esto revelará el campo de texto y la lista de eventos. Puedes ingresar términos en este campo para buscar eventos a los que deseas que responda tu bot. A continuación, 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. Una vez que hayas terminado la actualización de esta 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 del desarrollador 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 del 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 los 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`."
  }
}