Pour mettre à disposition votre assistant numérique (ou votre bot autonome) dans Slack, vous devez posséder un espace de travail Slack sur lequel vous disposez de droits d'accès permettant de créer une application Slack.

Si vous ne disposez pas d'un tel espace de travail Slack, vous pouvez en créer-un. Reportez-vous à la page Créer un espace de travail de Slack.

1. Accédez à la page Vos applications de Slack.

2. Cliquez sur Créer une application Slack, puis sélectionnez De zéro.

3. Dans la boîte de dialogue Créer une application Slack, remplissez les champs Nom de l'application et Espace de travail de développement Slack, puis cliquez sur Créer une application.

   Une fois l'application créée, la page Informations de base apparaît.

4. Faites défiler la page jusqu'à la section Informations d'identification de l'application et notez les valeurs ID client, Clé secrète client et Clé secrète de signature.

   Vous aurez besoin de ces informations d'identification lors de la configuration du canal dans Digital Assistant.

Ajoutez des portées OAuth pour les droits d'accès que vous voulez accorder au bot et à l'utilisateur.

1. Dans la barre de navigation de gauche de la console Web de votre application Slack, dans la section Fonctionnalités, sélectionnez OAuth et droits d'accès.

2. Accédez à la section Portées de la page.

3. Les portées appartiennent aux catégories suivantes :

   • Portées de jeton de bot
   • Portées de jeton utilisateur

4. Dans la section Portées de jeton de bot, ajoutez les portées correspondant aux droits d'accès au niveau du bot à accorder. Au minimum, les portées de jeton de bot suivantes sont obligatoires :

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

   Selon les fonctionnalités de la brique, d'autres portées peuvent être requises. Par exemple, les portées suivantes sont requises pour l'utilisation des pièces jointes :

   • files:read
   • files:write

5. Dans la section Portées de jeton utilisateur, ajoutez les portées correspondant aux droits d'accès au niveau de l'utilisateur à accorder. Les portées de jeton utilisateur suivantes sont obligatoires :

   • files:read
   • files:write

Selon les exigences associées à votre bot, vous devrez peut-être ajouter d'autres portées.

1. Revenez en haut de la page OAuth et droits d'accès.

2. Dans la section Jetons et URL de réacheminement OAuth, cliquez sur Installer sur l'espace de travail.

   Une page apparaît et indique ce que l'application pourra faire.

3. En bas de la page, cliquez sur Autoriser.

Une fois cette étape terminée, vous devez voir l'application dans votre espace de travail Slack en sélectionnant Applications dans la navigation de gauche.

1. Dans Digital Assistant, cliquez sur Canaux dans le menu de gauche, puis sélectionnez Utilisateurs.

2. Cliquez sur + Canal pour ouvrir la boîte de dialogue Créer un canal.

3. Nommez votre canal.

4. Choisissez Slack comme type de canal.

5. Renseignez les valeurs ID client, Clé secrète client et Clé secrète de signature que vous avez obtenues lors de la création de l'application Slack.

   Vous pouvez récupérer ces valeurs sur la page Paramètres de votre application Slack.

6. Si vous configurez le canal pour les discussions de groupe et que vous souhaitez que les messages soient envoyés au groupe sans mentionner le nom de l'application Slack, sélectionnez Autoriser les messages sans mention d'application dans la discussion de groupe.

7. Cliquez sur Créer.

8. Sur la page Canaux, copiez l'URL de webhook et collez-la dans un emplacement pratique de votre système. Vous en aurez besoin pour terminer la configuration de l'application Slack.

9. Cliquez sur et sélectionnez l'assistant numérique ou la brique à associer au canal.

10. Dans la liste déroulante Acheminer vers, sélectionnez l'assistant numérique ou la brique à associer au canal.

11. Activez la commande Canal activé.

1. Dans la barre de navigation de gauche de la console Web pour votre application Slack, sélectionnez Interactivité et raccourcis.

2. Activez l'option Interactivité.

3. Dans les champs URL de demande et URL de chargement d'options, collez l'URL de webhook générée lors de la création du canal dans Digital Assistant.

4. Cliquez sur Enregistrer les modifications.

5. Dans la barre de navigation de gauche, sélectionnez OAuth et droits d'accès.

6. Dans le champ URL de réacheminement, cliquez sur Ajouter une nouvelle URL de réacheminement.

7. Collez l'URL du webhook, ajoutez /authorizeV2 et cliquez sur Ajouter.

8. Cliquez sur Enregistrer les URL.

9. Dans la navigation de gauche, sélectionnez Accueil de l'application.

10. Dans la section Présence de votre application dans Slack, activez l'option Toujours afficher mon bot comme étant en ligne.

11. Faites défiler la page vers le bas pour afficher la section Afficher les onglets, puis activez la bascule Onglet Messages.

12. Cochez la case Autoriser les utilisateurs à envoyer des commandes et des messages à barres obliques à partir de l'onglet Messages.

13. Dans la barre de navigation de gauche, sélectionnez Abonnements d'événement.

14. Activez l'option Activer les événements.

15. Dans le champ URL de demande, collez l'URL de webhook.

    Une fois que vous avez entré l'URL, un libellé Vérifié vert doit apparaître à côté du libellé de l'URL de demande.

16. Développez la section S'inscrire aux événements de bot de la page, cliquez sur Ajouter un événement utilisateur de bot et ajoutez l'événement suivant :

    • message.im
17. Si vous prévoyez de rendre le bot disponible dans les discussions de groupe, ajoutez également les événements suivants :
    • app_mention
    • message.mpim
    • message.channels

18. Cliquez sur Enregistrer les modifications.

19. Dans la navigation de gauche, sélectionnez Gérer la distribution.

20. Cliquez sur le bouton Ajouter à Slack, puis sur Autoriser.

    A ce stade, vous devez obtenir le message indiquant que vous avez installé votre application dans Slack.

Une fois que vous avez fini de configurer le canal Slack et la messagerie, vous pouvez tester votre bot (assistant numérique ou brique) dans Slack.

1. Ouvrez l'espace de travail Slack sur lequel vous avez installé l'application.

2. Dans la barre de navigation de gauche, sélectionnez l'application associée à votre assistant numérique.

3. Dans le champ Message, saisissez du texte pour commencer à communiquer avec l'assistant numérique.

A partir de la version 20.6 d'Oracle Digital Assistant, la création de canaux Slack est basée sur un flux OAuth mis à jour dans les applications Slack. Ce flux mis à jour permet une plus grande précision au niveau des portées. Les instructions relatives à la configuration de canal dans ce manuel sont basées sur le nouveau flux OAuth.

Pour plus d'informations sur le flux OAuth mis à jour, reportez-vous à https://api.slack.com/authentication/oauth-v2.

Les canaux Slack de Digital Assistant prennent en charge les fonctionnalités suivantes :

• texte (envoi et réception),
• images (envoi et réception),
• fichiers (prise en charge partielle de l'envoi et complète de la réception)
• emojis (prise en charge partielle de l'envoi et complète de la réception)
• liens,
• postbacks,
• propriétés personnalisées,
• composants de carrousel (affichés verticalement au lieu d'horizontalement)
• composants de liste.

Slack vous permet de formater les messages à l'aide d'une démarque. Reportez-vous à https://api.slack.com/reference/surfaces/formatting dans la documentation de l'API Slack.

Si vous ciblez votre brique sur plusieurs canaux avec des fonctionnalités et une syntaxe de formatage différentes, vous pouvez utiliser le balisage HTML de base dans vos messages. Si vous le faites, ce balisage sera automatiquement converti au format de balisage de Slack lorsque le message sera transmis au canal. Cela est particulièrement utile si vous ciblez vos compétences sur d'autres canaux en plus de Slack. Reportez-vous à Formatage de texte enrichi dans les canaux.

Les canaux Slack de Digital Assistant présentent les contraintes de message suivantes :

• Messages texte
  • Longueur maximale du message texte : 3 000 caractères. Si la longueur est supérieure à 3 000, le texte est divisé en plusieurs messages.
  • Longueur maximale du libellé d'action de texte : 30 caractères
  • Types d'action de texte autorisés : postback, URL
• Cartes horizontales
  • Pris en charge ? : non, la disposition de la carte est convertie en mode vertical.
• Cartes verticales
  • Longueur maximale du titre : 3 000 caractères
  • Longueur maximale de la description : 3 000 caractères
  • Longueur maximale du libellé d'action de carte : 30 caractères
  • Nombre maximal de cartes : 100
  • Types d'action de carte autorisés : postback, URL
  • Types d'action de liste de cartes autorisés : postback, URL
• Messages de pièce jointe
  • Pris en charge ? : oui
  • Types d'action autorisés : postback, URL
• Boutons d'action
  • Longueur maximale du libellé d'action globale : 30 caractères
  • Types d'action globale autorisés : postback, URL

Pour les canaux Slack, vous pouvez étendre les fonctionnalités des composants Common Response (Réponse commune) avec des fonctions spécifiques à Slack.

Pour accéder aux extensions, utilisez l'élément channelCustomProperties des métadonnées du composant Common Response et définissez les propriétés appropriées. Le format du code est le suivant :

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

Voici les propriétés personnalisées disponibles pour les canaux Slack :

L'exemple ci-dessous illustre l'utilisation de la propriété personnalisée 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

L'exemple ci-dessous illustre l'utilisation de la propriété personnalisée renderActionsAsDropDown avec des propriétés imbriquées pour postbackActions, cardPostbackActions et 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

Pour obtenir des informations plus générales sur channelCustomProperties, reportez-vous à Extensions propres à un canal.

Vous pouvez créer un bouton pour appeler un modal Slack dans un composant de réponse commune. Pour ce faire, définissez la propriété d'action du bouton sur system.openModal et incluez une variable nommée system.dialogPayload de type map. Les métadonnées d'action doivent ressembler à ce fragment de code :

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

La valeur de system.dialogPayload est généralement définie dans un composant personnalisé, mais elle peut également être définie de façon incorporée ou à l'aide d'un composant Définir une variable.

Lorsque l'utilisateur soumet une entrée dans le dialogue Slack, le composant Réponse commune définit la transition system.dialogSubmitted pour passer à un état qui traite les valeurs soumises. Les valeurs soumises sont stockées dans des variables portant le même nom.

Il vous appartient de déterminer comment traiter les valeurs de champ soumises. Le composant Réponse commune n'effectue aucune mise à jour automatique des valeurs d'entité. Il stocke uniquement les valeurs dans des variables. En général, vous traitez ces valeurs dans un composant personnalisé, afin de pouvoir effectuer des validations supplémentaires si nécessaire. Dans la forme la plus simple, vous pouvez stocker les valeurs de champ soumises dans une variable de chaîne, puis utiliser le composant Mettre en correspondance une entité pour mettre à jour les valeurs d'entité.

Pour obtenir une documentation complète sur les types d'élément pris en charge dans les données traitées de la boîte de dialogue Slack, reportez-vous à https://api.slack.com/reference/block-kit/block-elements. La structure que vous indiquez dans la charge utile de dialogue doit être identique à celle décrite dans la documentation Slack.

Vous pouvez créer un bouton permettant d'appeler une boîte de dialogue Slack dans un composant de réponse commune. Pour ce faire, définissez la propriété d'action du bouton sur system.openDialog et incluez une variable nommée system.dialogPayload. Les métadonnées d'action doivent ressembler à ce fragment de code :

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

La valeur de system.dialogPayload est généralement définie dans un composant personnalisé, mais elle peut également être définie de façon incorporée ou à l'aide d'un composant Définir une variable.

Lorsque l'utilisateur soumet une entrée dans le dialogue Slack, le composant Réponse commune définit la transition system.dialogSubmitted pour passer à un état qui traite les valeurs soumises. Les valeurs soumises sont stockées dans des variables de flux de dialogue portant le même nom.

Il vous appartient de déterminer comment traiter les valeurs de champ soumises. Le composant Réponse commune n'effectue aucune mise à jour automatique des valeurs d'entité. Il stocke uniquement les valeurs dans des variables de flux de dialogue. En général, vous traitez ces valeurs dans un composant personnalisé, afin de pouvoir effectuer des validations supplémentaires si nécessaire. Dans la forme la plus simple, vous pouvez stocker les valeurs de champ soumises dans une variable de chaîne, puis utiliser le composant Mettre en correspondance une entité pour mettre à jour les valeurs d'entité.

Pour obtenir la documentation sur les autres propriétés et types d'élément pris en charge dans la charge utile de dialogue Slack, reportez-vous à https://api.slack.com/dialogs#top-level_dialog_attributes. La structure de la charge utile de dialogue doit être identique à celle décrite dans la documentation Slack.