Para que el asistente digital (o el bot autónomo) esté disponible en Slack, necesita un espacio de trabajo de Slack a su disposición, donde cuente con los permisos necesarios para crear una aplicación de Slack.

Si no dispone de dicho espacio de trabajo, puede crear uno. Consulte la página Creación de un nuevo espacio de trabajo de Slack.

1. Vaya a la página Your Apps de Slack.

2. Haga clic en Crear una aplicación de Slack y, a continuación, seleccione Desde cero.

3. En el cuadro de diálogo Create a Slack App, rellene los campos App Name y Development Slack Workspace y haga clic en Create App.

   Una vez creada la aplicación, se muestra la página Basic Information.

4. Desplácese a la sección App Credentials de la página y anote los valores de Client ID, Client Secret y Signing Secret.

   Necesitará estas credenciales para configurar el canal en Digital Assistant.

Agregue ámbitos de OAuth para los permisos que desea otorgar al bot y al usuario.

1. En la navegación izquierda de la consola web de la aplicación de Slack, dentro de la sección Features, seleccione OAuth y permisos.

2. Desplácese a la sección Scopes de la página.

3. Los ámbitos entran en las siguientes categorías:

   • Ámbitos de token de bot
   • Ámbitos de token de usuario

4. En la sección Ámbitos de token de bot, agregue los ámbitos que corresponden a los permisos de nivel de bot que desea permitir. Como mínimo, se necesitan los siguientes ámbitos de token de bot:

   • chat:write
   • im:history
   • users:read

   Dependiendo de las características de la aptitud, es posible que se necesiten otros ámbitos. Por ejemplo, los siguientes ámbitos son necesarios para trabajar con asociaciones:

   • files:read
   • files:write

5. En la sección Ámbitos de token de usuario, agregue los ámbitos que corresponden a los permisos de nivel de usuario que desea permitir. Se necesitan los siguientes ámbitos de token de usuario:

   • files:read
   • files:write

Dependiendo de los requisitos del bot, puede que deba agregar otros ámbitos.

1. Vuelva a la parte superior de la página OAuth & Permissions.

2. En la sección OAuth Tokens & Redirect URLs, haga clic en Install to Workspace.

   Aparecerá una página en la que se mostrará lo que podrá hacer la aplicación.

3. En la parte inferior de la página, haga clic en Allow.

Una vez completado este paso, debe poder ver la aplicación en el espacio de trabajo de Slack seleccionando Apps en la navegación izquierda.

1. En Digital Assistant, haga clic en Canales en el menú de la izquierda y, a continuación, seleccione Usuarios.

2. Haga clic en Agregar canal para abrir el cuadro de diálogo Crear canal.

3. Asigne un nombre al canal.

4. Seleccione Slack como tipo de canal.

5. Rellene los valores de ID de cliente, Secreto de cliente y Secreto de firma obtenidos al crear la aplicación de Slack.

   Puede recuperar estos valores en la página Settings de la aplicación de Slack.

6. Si está configurando el canal para los chats de grupo y desea que los mensajes vayan al grupo sin mencionar el nombre de la aplicación Slack, seleccione Permitir mensajes sin mención de aplicación en chat de grupo.

7. Haga clic en Crear.

8. En la página Canales, copie el URL del webhook y péguelo en algún lugar del sistema de fácil acceso. Necesitará estos datos para terminar de configurar la aplicación de Slack.

9. Haga clic en y seleccione el asistente digital o la aptitud que desea asociar al canal.

10. En el desplegable Encaminar a, seleccione el asistente digital o la aptitud que quiera asociar al canal.

11. Active el control Canal activado.

1. En la navegación izquierda de la consola web de la aplicación Slack, seleccione Interactivity & Shortcuts.

2. Active el conmutador Interactivity.

3. En los campos Request URL y Options Load URL, pegue el URL del webhook generado al crear el canal en Digital Assistant .

4. Haga clic en Save Changes.

5. En la navegación izquierda, seleccione OAuth & Permissions.

6. En el campo Redirect URLs, haga clic en Add New Redirect URL.

7. Pegue la URL de webhook, agregue /authorizeV2 y haga clic en Add.

8. Haga clic en Save URLs.

9. En la navegación izquierda, seleccione App Home.

10. En la sección Your App’s Presence in Slack, active el conmutador Always Show My Bot as Online.

11. Desplácese hacia abajo en la página hasta la sección Mostrar separadores y active el conmutador Separador Mensajes.

12. Seleccione la casilla de control Permitir a los usuarios enviar comandos y mensajes de barra diagonal desde el separador Mensajes.

13. En la navegación izquierda, seleccione Event Subscriptions.

14. Active el conmutador Enable Events.

15. En el campo Request URL, pegue el URL del webhook.

    Tras introducir el URL, debería aparecer una etiqueta Verified de color verde junto al campo Request URL.

16. Expanda la sección Suscribirse a eventos de bot de la página, haga clic en Agregar evento de usuario de bot y agregue el siguiente evento:

    • message.im
17. Si tiene previsto hacer que el bot esté disponible en chats de grupo, agregue también los siguientes eventos:
    • app_mention
    • message.mpim
    • message.channels

18. Haga clic en Save Changes.

19. En la navegación izquierda, seleccione Manage Distribution.

20. Haga clic en el botón Add to Slack y, a continuación, en Allow.

    En este momento, debe mostrarse el mensaje You've successfully installed your App in Slack.

Una vez completada la configuración de la mensajería y el canal de Slack, puede probar el bot (asistente digital o aptitud) en Slack.

1. Abra el espacio de trabajo de Slack en el que ha instalado la aplicación.

2. En la barra de navegación izquierda, seleccione la aplicación asociada al asistente digital.

3. En el campo Message, introduzca el texto para empezar a comunicarse con el asistente digital.

A partir de la versión 20.6 de Oracle Digital Assistant, la creación de canales de Slack se basa en un flujo de OAuth de actualizado en aplicaciones de Slack. Este flujo actualizado permite más ámbitos granulares. Las instrucciones para la configuración del canal en esta guía se basan en el nuevo flujo de OAuth.

Consulte https://api.slack.com/authentication/oauth-v2 para obtener más información sobre el flujo de OAuth actualizado.

Los canales de Slack en Digital Assistant admiten las siguientes capacidades:

• texto (tanto envío como recepción)
• imágenes (tanto envío como recepción)
• archivos (soporte parcial para el envío, soporte completo para la recepción)
• emojis (soporte parcial para envío, soporte completo para recepción)
• enlaces
• devoluciones
• propiedades personalizadas
• componentes en carrusel (representados verticalmente, no horizontalmente)
• componentes de la lista

Slack le permite formatear mensajes con Markdown. Consulte https://api.slack.com/reference/surfaces/formatting en la documentación de la API de Slack.

Si va a dirigir la aptitud a varios canales con diferentes capacidades de formato y sintaxis, puede utilizar el marcado HTML básico en los mensajes. Si lo hace, ese marcado se convertirá automáticamente al formato de rebaja de Slack cuando el mensaje se transmita al canal. Esto es particularmente útil si está dirigiendo sus habilidades a otros canales además de Slack. Consulte Formato de texto enriquecido en canales.

Los canales de Slack en Digital Assistant presentan las siguientes restricciones de mensaje:

• Mensajes de texto
  • Longitud máxima del mensaje de texto: 3000 caracteres. Si la longitud supera los 3000 caracteres, el texto se dividirá en varios mensajes.
  • Longitud máxima de la etiqueta de acción de texto: 30 caracteres
  • Tipos de acciones de texto permitidas: devolución, URL
• Tarjetas horizontales
  • ¿Se admite? No. El diseño de la tarjeta pasa a ser vertical.
• Tarjetas verticales
  • Longitud máxima del título: 3000 caracteres
  • Longitud máxima de la descripción: 3000 caracteres
  • Longitud máxima de la etiqueta de acción de la tarjeta: 30 caracteres
  • Número máximo de tarjetas: 100
  • Tipos de acciones de tarjeta permitidas: retroceso, URL
  • Tipos de acciones de lista de tarjetas permitidas: retroceso, URL
• Mensajes anexos
  • ¿Se admite?: sí
  • Tipos de acciones permitidas: devolución, URL
• Botones de acción
  • Longitud máxima de la etiqueta de acción global: 30 caracteres
  • Tipos de acciones globales permitidas: devolución, URL

Para los canales de Slack, puede ampliar la funcionalidad de los componentes de respuesta común con capacidades específicas de Slack.

Para acceder a las extensiones, utilice el elemento channelCustomProperties de los metadatos del componente de respuesta común y defina las propiedades adecuadas. El código tiene el formato siguiente:

...
            channelCustomProperties:
            - channel: "slack"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

A continuación, se muestran las propiedades personalizadas disponibles para los canales de Slack:

A continuación, se muestra un ejemplo de uso de la propiedad personalizada renderActionsAsDropDown.

responseItems:
- type:
 "text"
  text: "Here is a list of the UI features of the Common Response Component:"
  actions:
  - ...
  channelCustomProperties:
  - channel: "slack"
    properties:
      renderActionsAsDropDown: false

Este es un ejemplo de uso de la propiedad personalizada renderActionsAsDropDown con propiedades anidadas para postbackActions, cardPostbackActions y globalPostbackActions.

responseItems:
- type: "text"
  text: "Here is a list of the UI features of the Common Response Component:"
  actions:
  - ...
  channelCustomProperties:
  - channel: "slack"
    properties:
      renderActionsAsDropDown:
        postbackActions: false
        cardPostbackActions: true
        globalPostbackActions: true

Para obtener más información general sobre channelCustomProperties, consulte Extensiones específicas del canal.

Puede crear un botón para llamar a un modal de Slack en un componente de respuesta común. Para ello, defina la propiedad de acción del botón en system.openModal e incluya una variable denominada system.dialogPayload de tipo map. Los metadatos de acción deben parecerse al siguiente fragmento:

          actions:
          - label: "Open Dialog"
            type: "postback"
            payload:
              action: "system.openModal" 
              variables:
                system.dialogPayload: ${dialogPayload}

El valor de system.dialogPayload se suele definir en un componente personalizado, pero también se puede definir en línea o mediante un componente Definir Variable.

Cuando el usuario envía la entrada en el diálogo de Slack, el componente de respuesta común define la transición system.dialogSubmitted para pasar a un estado que procese los valores enviados. Los valores enviados se almacenan en variables con el mismo nombre.

Le corresponde a usted determinar cómo procesar los valores de campo enviados. El componente Respuesta Común NO realiza ninguna actualización automática de los valores de entidad. Solo almacena los valores en variables. Normalmente procesará estos valores en un componente personalizado, por lo que puede realizar validaciones adicionales si es necesario. En su forma más sencilla, puede almacenar los valores de campo enviados en una variable de cadena y, a continuación, utilizar el componente Entidad de Coincidencia para actualizar los valores de entidad.

Para obtener documentación completa sobre los tipos de elementos soportados en la carga útil del cuadro de diálogo de Slack, consulte https://api.slack.com/reference/block-kit/block-elements. La estructura que especifique en la carga útil de diálogo debe ser idéntica a la estructura descrita en la documentación de Slack.

Puede crear un botón para llamar a un diálogo de Slack en un componente de respuesta común. Para ello, defina la propiedad de acción del botón en system.openDialog e incluya una variable denominada system.dialogPayload. Los metadatos de acción deben parecerse al siguiente fragmento:

            actions:
              - label: "Edit"
                type: "postback"
                payload:
                  action: "system.openDialog"
                  variables:
                    system.dialogPayload: ${dialogPayload}

El valor de system.dialogPayload se suele definir en un componente personalizado, pero también se puede definir en línea o mediante un componente Definir Variable.

Cuando el usuario envía la entrada en el diálogo de Slack, el componente de respuesta común define la transición system.dialogSubmitted para pasar a un estado que procese los valores enviados. Los valores enviados se almacenan en variables de flujo de diálogo con el mismo nombre.

Le corresponde a usted determinar cómo procesar los valores de campo enviados. El componente Respuesta Común NO realiza ninguna actualización automática de los valores de entidad. Solo almacena los valores en variables de flujo de diálogo. Normalmente procesará estos valores en un componente personalizado, por lo que puede realizar validaciones adicionales si es necesario. En su forma más sencilla, puede almacenar los valores de campo enviados en una variable de cadena y, a continuación, utilizar el componente Entidad de Coincidencia para actualizar los valores de entidad.

Para obtener la documentación sobre otras propiedades y tipos de elementos soportados en la carga útil del diálogo de Slack, consulte https://api.slack.com/dialogs#top-level_dialog_attributes. La estructura de la carga útil de diálogo debe ser idéntica a la estructura descrita en la documentación de Slack.