Per rendere disponibile l'assistente digitale (o il bot standalone) in Slack, è necessario disporre di un'area di lavoro Slack in cui si dispone delle autorizzazioni necessarie per creare un'applicazione Slack.

Se non si dispone di un'area di lavoro di questo tipo, è possibile crearne una propria. Vedere la pagina Crea una nuova area di lavoro di Slack.

1. Andare alla pagina Applicazioni personali di Slack.

2. Fare clic su Crea un'applicazione Slack, quindi selezionare Da zero.

3. Nella finestra di dialogo Crea un'applicazione Slack, compilare i campi Nome applicazione e Area di lavoro Slack per lo sviluppo e fare clic su Crea applicazione.

   Una volta creata l'applicazione, viene visualizzata la pagina Informazioni di base.

4. Scorrere fino alla sezione Credenziali applicazione della pagina e annotare i valori dei campi Client ID, Client Secret e Signing Secret.

   Queste credenziali sono necessarie quando si imposta il canale in Digital Assistant.

Aggiungere gli ambiti OAuth per le autorizzazioni che si desidera concedere al bot e all'utente.

1. Nella navigazione a sinistra della console Web per l'applicazione Slack, nella sezione Funzioni, selezionare OAuth e autorizzazioni.

2. Scorrere fino alla sezione Scope della pagina.

3. Gli ambiti rientrano nelle seguenti categorie:

   • Ambiti token bot
   • Ambiti token utente

4. Nella sezione Ambiti token bot aggiungere gli ambiti che corrispondono alle autorizzazioni a livello di bot che si desidera consentire. Sono richiesti almeno gli ambiti del token bot seguenti:

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

   A seconda delle caratteristiche dello skill, potrebbero essere necessari altri ambiti. Ad esempio, per l'utilizzo degli allegati sono necessari gli ambiti riportati di seguito.

   • files:read
   • files:write

5. Nella sezione Ambiti token utente aggiungere gli ambiti che corrispondono alle autorizzazioni a livello utente che si desidera consentire. Sono necessari gli ambiti del token utente seguenti:

   • files:read
   • files:write

A seconda dei requisiti del bot, potrebbe essere necessario aggiungere altri ambiti.

1. Scorrere indietro fino alla parte superiore della pagina OAuth & Autorizzazioni.

2. Nella sezione OAuth URL token e reindirizzamento fare clic su Installa nell'area di lavoro.

   Verrà visualizzata una pagina che mostra cosa l'app sarà in grado di fare.

3. Nella parte inferiore della pagina fare clic su Consenti.

Dopo aver completato questo passo, è possibile visualizzare l'applicazione nell'area di lavoro Slack selezionando Applicazioni nella barra di navigazione a sinistra.

1. In Digital Assistant, fare clic sui canali nel menu a sinistra, quindi scegliere Utenti.

2. Fare clic su + Canale per aprire la finestra di dialogo Crea canale.

3. Dai un nome al tuo canale.

4. Scegliere Slack come tipo di canale.

5. Inserire i valori per ID client, Segreto client e Segreto firma ottenuti durante la creazione dell'applicazione Slack.

   È possibile recuperare questi valori dalla pagina Impostazioni dell'applicazione Slack.

6. Se si sta impostando il canale per le chat di gruppo e si desidera che i messaggi vengano inviati al gruppo senza menzionare il nome dell'applicazione Slack, selezionare Consenti messaggi senza menzione applicazione nella chat di gruppo.

7. Fare clic su Crea.

8. Nella pagina Canali, copiare l'URL WebHook e incollarlo in un punto appropriato nel sistema. Avrai bisogno di questo per completare l'impostazione dell'app Slack.

9. Fare clic su e selezionare l'assistente digitale o lo skill che si desidera associare al canale.

10. Nell'elenco a discesa Invia a selezionare l'assistente digitale o lo skill che si desidera associare al canale.

11. Accendere il controllo Channel Enabled.

1. Nella navigazione a sinistra della console Web per l'applicazione Slack, selezionare Interattività e collegamenti.

2. Accendere lo switch Interattività.

3. In entrambi i campi URL richiesta e URL caricamento opzioni incollare l'URL del webhook generato al momento della creazione del canale in Digital Assistant.

4. Fare clic su Salva modifiche.

5. Nella navigazione a sinistra, selezionare OAuth & Permissions.

6. Nel campo Redirect URL fare clic su Add New Redirect URL.

7. Incollare l'URL del webhook, aggiungere /authorizeV2 e fare clic su Aggiungi.

8. Fare clic su Save URLs.

9. Nella navigazione a sinistra selezionare Home applicazione.

10. Nella sezione Presenza dell'applicazione in Slack, attivare lo switch Mostra sempre il bot come online.

11. Scorrere la pagina fino alla sezione Mostra schede e attivare l'opzione Scheda Messaggi.

12. Selezionare la casella di controllo Consenti agli utenti di inviare comandi e messaggi della barra multifunzione dalla scheda Messaggi.

13. Nella navigazione a sinistra selezionare Sottoscrizioni evento.

14. Impostare lo switch Enable Events su ON.

15. Nel campo URL richiesta incollare l'URL del webhook.

    Dopo aver immesso l'URL, accanto all'etichetta URL richiesta deve essere visualizzata un'etichetta verde Verificato.

16. Espandere la sezione Esegui sottoscrizione agli eventi bot della pagina, fare clic su Aggiungi evento utente bot e aggiungere l'evento seguente:

    • message.im
17. Se si prevede di rendere disponibile il bot nelle chat di gruppo, aggiungere anche gli eventi riportati di seguito.
    • app_mention
    • message.mpim
    • message.channels

18. Fare clic su Salva modifiche.

19. Nella navigazione a sinistra selezionare Manage Distribution.

20. Fare clic sul pulsante Aggiungi a Slack, quindi su Consenti.

    A questo punto, si dovrebbe ricevere il messaggio È stata installata correttamente l'applicazione in Slack.

Una volta completata la configurazione del canale Slack e della messaggistica, puoi testare il bot (assistente digitale o abilità) in Slack.

1. Aprire l'area di lavoro Slack in cui è stata installata l'applicazione.

2. Nella barra di navigazione a sinistra, selezionare l'applicazione associata all'assistente digitale.

3. Nel campo Messaggio immettere il testo per iniziare a comunicare con l'assistente digitale.

A partire dalla versione 20.6 di Oracle Digital Assistant, la creazione dei canali Slack si basa su un flusso OAuth aggiornato nelle app Slack. Questo flusso aggiornato abilita ambiti più granulari. Le istruzioni per l'impostazione del canale in questa guida si basano sul nuovo flusso OAuth.

Per informazioni dettagliate sul flusso OAuth aggiornato, vedere https://api.slack.com/authentication/oauth-v2.

I canali Slack in Digital Assistant supportano le seguenti funzionalità:

• testo (sia di invio che di ricezione)
• immagini (sia di invio che di ricezione)
• file (supporto parziale per l'invio, supporto completo per la ricezione)
• emoji (supporto parziale per l'invio, supporto completo per la ricezione)
• collegamenti
• postback
• proprietà personalizzate
• componenti della giostra (ma resi verticalmente anziché orizzontalmente)
• elencare i componenti

Slack consente di formattare i messaggi utilizzando il markdown. Vedere https://api.slack.com/reference/surfaces/formatting nella documentazione dell'interfaccia API Slack.

Se si intende indirizzare la propria abilità a più canali con diverse funzionalità di formattazione e sintassi, è possibile utilizzare il markup HTML di base nei messaggi. In tal caso, il markup verrà convertito automaticamente nel formato di markdown di Slack quando il messaggio viene trasmesso al canale. Ciò è particolarmente utile se si mirano le proprie competenze ad altri canali oltre a Slack. Vedere Formattazione di testo ricco nei canali.

I canali Slack in Digital Assistant hanno i seguenti vincoli di messaggio:

• Messaggi di testo
  • Lunghezza massima del messaggio di testo: 3000 caratteri. Se la lunghezza supera 3000, il testo viene suddiviso su più messaggi.
  • Lunghezza massima dell'etichetta dell'azione di testo: 30 caratteri
  • Tipi di azioni di testo consentiti: Postback, URL
• Schede orizzontali
  • Supportato?: No. Il layout della scheda viene convertito in verticale.
• Schede verticali
  • Lunghezza massima del titolo: 3000 caratteri
  • Lunghezza massima della descrizione: 3000 caratteri
  • Lunghezza massima dell'etichetta di azione della scheda: 30 caratteri
  • Numero massimo di carte: 100
  • Tipi di azioni della carta consentiti: Postback, URL
  • Tipi di azioni elenco carte consentite: Postback, URL
• Messaggi allegato
  • Supportato?: Sì
  • Tipi di azioni consentite: Postback, URL
• Pulsanti di azione
  • Lunghezza massima dell'etichetta di azione globale: 30 caratteri
  • Tipi di azioni globali consentiti: Postback, URL

Per i canali Slack, è possibile estendere la funzionalità dei componenti Common Response con funzionalità specifiche di Slack.

Per accedere alle estensioni, utilizzare l'elemento channelCustomProperties nei metadati del componente Risposta comune e impostare le proprietà appropriate. Il codice ha il formato seguente:

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

Di seguito sono riportate le proprietà personalizzate disponibili per i canali Slack.

Di seguito è riportato un esempio di utilizzo della proprietà personalizzata 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

Di seguito è riportato un esempio di utilizzo della proprietà personalizzata renderActionsAsDropDown con proprietà nidificate per postbackActions, cardPostbackActions e 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

Per informazioni più generali su channelCustomProperties, vedere Estensioni specifiche del canale.

È possibile creare un pulsante per richiamare un modale Slack in un componente Risposta comune. A tale scopo, impostare la proprietà dell'azione del pulsante su system.openModal e includere una variabile denominata system.dialogPayload di tipo map. I metadati dell'azione devono avere un aspetto simile a questo snippet:

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

Il valore di system.dialogPayload viene in genere impostato in un componente personalizzato, ma può anche essere definito in linea o utilizzando un componente Imposta variabile.

Quando l'utente sottomette l'input nella finestra di dialogo Slack, il componente Risposta comune imposta la transizione system.dialogSubmitted per passare a uno stato che elabora i valori sottomessi. I valori sottomessi vengono memorizzati in variabili con lo stesso nome.

Spetta all'utente determinare come elaborare i valori dei campi sottomessi. Il componente Risposta comune NON esegue alcun aggiornamento automatico dei valori di entità. Memorizza solo i valori nelle variabili. In genere questi valori vengono elaborati in un componente personalizzato, in modo da poter eseguire convalide aggiuntive, se necessario. Nel suo modulo più semplice, è possibile memorizzare i valori dei campi sottomessi in una variabile stringa e quindi utilizzare il componente Entità corrispondenza per aggiornare i valori delle entità.

Per la documentazione completa sui tipi di elemento supportati nel payload della finestra di dialogo Slack, vedere https://api.slack.com/reference/block-kit/block-elements. La struttura specificata nel payload della finestra di dialogo deve essere identica alla struttura descritta nella documentazione di Slack.

È possibile creare un pulsante per richiamare una finestra di dialogo Slack in un componente Risposta comune. A tale scopo, impostare la proprietà dell'azione del pulsante su system.openDialog e includere una variabile denominata system.dialogPayload. I metadati dell'azione devono avere un aspetto simile a questo snippet:

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

Il valore di system.dialogPayload viene in genere impostato in un componente personalizzato, ma può anche essere definito in linea o utilizzando un componente Imposta variabile.

Quando l'utente sottomette l'input nella finestra di dialogo Slack, il componente Risposta comune imposta la transizione system.dialogSubmitted per passare a uno stato che elabora i valori sottomessi. I valori sottomessi vengono memorizzati nelle variabili di flusso della finestra di dialogo con lo stesso nome.

Spetta all'utente determinare come elaborare i valori dei campi sottomessi. Il componente Risposta comune NON esegue alcun aggiornamento automatico dei valori di entità. Memorizza solo i valori nelle variabili di flusso della finestra di dialogo. In genere questi valori vengono elaborati in un componente personalizzato, in modo da poter eseguire convalide aggiuntive, se necessario. Nel suo modulo più semplice, è possibile memorizzare i valori dei campi sottomessi in una variabile stringa e quindi utilizzare il componente Entità corrispondenza per aggiornare i valori delle entità.

Per la documentazione relativa ad altre proprietà e tipi di elemento supportati nel payload della finestra di dialogo Slack, vedere https://api.slack.com/dialogs#top-level_dialog_attributes. La struttura del payload della finestra di dialogo deve essere identica alla struttura descritta nella documentazione di Slack.