Slack

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:

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.

  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, habilitarás OAuth, Event URLs de solicitudes (proporcionadas por Dialogflow) y 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 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" en color verde. arriba de la URL de la solicitud .

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

  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) a la izquierda. menú
  2. En la sección Share Your App with Your Workplace, haz clic en el botón Add to Botón de 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 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`."
  }
}