Slack

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La integración de Slack te permite crear fácilmente bots de Slack con comprensión del lenguaje natural basada en la tecnología de agentes conversacionales (Dialogflow CX).

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

• Esta integración solo admite la entrada de texto en el idioma predeterminado del agente.

Configura Slack

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

• Una cuenta de Slack
• Un lugar de trabajo de Slack

Crea un bot de Slack

1. Navega a tus apps de Slack.
2. Crea una nueva app de Slack a partir de un manifiesto de app. A continuación, se muestra un ejemplo de manifiesto. Asegúrate de que los campos oath_config y event_subscriptions coincidan con el manifiesto de ejemplo.

   display_information:
     name: Conversational Agents (Dialogflow CX)
     description: Conversational Agents (Dialogflow CX) integration
     background_color: "#1148b8"
   features:
     app_home:
       home_tab_enabled: false
       messages_tab_enabled: true
       messages_tab_read_only_enabled: false
     bot_user:
       display_name: CX
       always_online: true
   oauth_config:
     scopes:
       bot:
         - app_mentions:read
         - chat:write
         - im:history
         - im:read
         - im:write
         - incoming-webhook
   settings:
     event_subscriptions:
       request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
       bot_events:
         - app_mention
         - message.im
     org_deploy_enabled: false
     socket_mode_enabled: false
     token_rotation_enabled: false
   

3. Instala la aplicación en el lugar de trabajo que elijas
   • Token de OAuth del usuario del bot
     • Navega a Instalar app > Tokens de OAuth para tu espacio de trabajo > Token de OAuth del usuario bot
   • Token de firma
     • Navega a Información básica > Credenciales de la app > Secreto de firma

Configura agentes conversacionales (Dialogflow CX)

1. Haz clic en la pestaña Administrar en el panel izquierdo.
2. Haz clic en Integraciones en el menú de la izquierda.
3. Haz clic en el botón Conectar en la tarjeta Slack.
4. Completa la siguiente información:
   • Token de acceso
   • Token de firma
5. Elige un entorno, según corresponda.
6. Haz clic en Start.
7. Copia la URL de webhook.

Habilita el webhook en Slack

Regresa a la app de Slack y pega la URL del webhook en Event Subscriptions > Enable Events > Request URL.

Prueba

Nota: Asegúrate de habilitar la facturación en el proyecto antes de probar la integración.

Para probar la app configurada, menciónala en un canal de grupo o envíale un MD en el espacio de trabajo en el que la instalaste.

Mensajes de respuesta enriquecida

Los mensajes de respuesta enriquecida son compatibles con la carga útil personalizada en Entregas. Consulta la API de mensajes de Slack para conocer el formato de los mensajes.

Nota: Si no se especifica en la carga útil personalizada, el campo de canal se insertará automáticamente con el ID del canal del mensaje de entrada.

Por ejemplo, la siguiente carga útil personalizada proporciona un mensaje de texto simple de Slack:

{
  "text": "Hello, world"
}

Respuestas específicas del canal

Después de configurar las respuestas específicas del canal, el canal DF_CX_SLACK se usa automáticamente cuando el agente responde a los mensajes de Slack.