Inizia generando il Segreto applicazione e il token di accesso alla pagina in Facebook Messenger.

1. Accedi all'account dello sviluppatore di Facebook.

2. Crea una pagina Facebook che ospita il tuo bot. La descrizione, le immagini e la copertina aggiunte alla pagina identificheranno il bot per i suoi utenti.

3. Successivamente, crea l'app di Facebook che ti collegherai a questa pagina. Poiché si tratta di un'applicazione Messenger, scegliere Applicazioni per Messenger, quindi fare clic su Crea ID applicazione.
   
   Descrizione dell'impostazione dell'immagine: fbapp.png
   

   Se l'opzione Applicazioni per Messenger non è stata scelta in questa finestra di dialogo (ad esempio, se si sta creando un'applicazione di test), fare clic su Aggiungi prodotto nella barra di navigazione a sinistra, scegliere Messaggero nella pagina Impostazione prodotto, quindi fare clic su Per iniziare.
   
   Descrizione dell'immagine add-product.png
   

4. Nella pagina Dashboard dell'app Facebook, copia il segreto dell'app e incolla in un punto conveniente nel tuo sistema.
   
   Descrizione dell'immagine facebook-dashboard.png
   

   Avrai bisogno del segreto dell'app per completare la configurazione del tuo canale Facebook.

5. Nella dashboard dell'applicazione generare il token di accesso alla pagina selezionando la pagina Facebook.
   
   Descrizione dell'immagine page-access-token.png
   

6. Copiare il token di accesso e incollarlo in un punto appropriato.

   Questo token, che consente all'applicazione Facebook di accedere all'API di messaggistica di Facebook, consente di completare la definizione del canale in Digital Assistant.

Una volta completata la configurazione, sei pronto per attivare il canale Facebook.

• In Digital Assistant, selezionare il canale e attivare il controllo Canale abilitato.
• Fare clic su e selezionare l'assistente digitale o lo skill che si desidera associare al canale.

Ora puoi testare il bot attraverso il canale.

Con la configurazione del canale Facebook e della messaggistica completa, puoi testare il tuo bot utilizzando la tua pagina Facebook, Facebook Messenger (https://www.messenger.com/) e l'app Facebook Messenger sul tuo telefono (). Una volta individuato il bot nella ricerca, sei pronto per iniziare a chattare con esso. È possibile visualizzare in tempo reale le modifiche apportate al flusso della finestra di dialogo.

Descrizione della figura test-bot.png

Facebook Messenger consente di creare un menu persistente accanto al campo Messaggio. Per ulteriori informazioni sulla funzione, vedere https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/.

Ecco un esempio che mostra le voci di menu persistenti per "Order Pizza" e "Order Pasta":

Descrizione dell'immagine persistente-menu.jpg

I canali di Facebook Messenger in Digital Assistant supportano le seguenti funzionalità:

• testo (sia di invio che di ricezione)
• immagini (sia di invio che di ricezione)
• file (sia di invio che di ricezione)
• emoji (sia di invio che di ricezione)
• posizione, ma non più valida (sia di invio che di ricezione)
• collegamenti
• postback
• richieste di posizione
• proprietà personalizzate
• componenti carosello
• elencare i componenti

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, tale markup verrà automaticamente convertito nel formato di markdown di Facebook Messenger quando il messaggio viene trasmesso al canale. Questo è particolarmente utile se stai indirizzando le tue abilità ad altri canali oltre a Facebook Messenger. Vedere Formattazione di testo ricco nei canali.

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

• Messaggi di testo
  • Lunghezza massima del messaggio di testo: 640 caratteri. Se la lunghezza supera 640, il testo viene diviso su più messaggi.
  • Lunghezza massima dell'etichetta di azione testo: 20 caratteri
  • Tipi di azioni di testo consentiti: Postback, Call, URL
  • Numero massimo di azioni di testo: 3. Se ci sono più azioni di testo, il messaggio viene convertito in più schede orizzontali, con lo stesso testo utilizzato come titolo su ogni scheda e ogni scheda contenente fino a 3 azioni.
• Schede orizzontali
  • Lunghezza massima del titolo: 80 caratteri
  • Lunghezza massima della descrizione: 80 caratteri
  • Lunghezza massima dell'etichetta di azione della scheda: 20 caratteri
  • Numero massimo di carte: 10
  • Numero massimo di azioni carta: 3. Se il numero di azioni della scheda supera 3, la scheda viene duplicata per eseguire il rendering delle azioni della scheda rimanenti.
  • Numero minimo di azioni carta: 0
  • Numero massimo di azioni elenco carte: 0
  • È richiesta almeno una descrizione, un'immagine o un'azione?: Sì
  • Tipi di azioni della carta consentite: Postback, Call, URL, Condividi
  • Tipi di azioni elenco carte consentite: N/D
• Schede verticali
  • Non supportata
• Messaggi allegato
  • Supportato?: Sì
  • Azioni allegato consentite?: No
• Pulsanti di azione
  • Lunghezza massima dell'etichetta di azione globale: 20 caratteri
  • Numero massimo di azioni globali: 11
  • Tipi di azioni globali consentiti: Postback

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

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: "facebook"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Di seguito sono riportate le proprietà personalizzate disponibili per i canali di Facebook Messenger:

Di seguito è riportato un esempio di proprietà personalizzate definite a livello di elemento di risposta (top_element_style) e a livello di schede (webview_height_ratio e fallback_url):

responseItems:
  - type: "cards"
    cardLayout: "vertical"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        url: "${pizzas.moreInfo}"
        iteratorVariable: "pizzas"
        channelCustomProperties:
          - channel: "facebook"
            properties:
              webview_height_ratio: "compact"
              fallback_url: "http://www.oracle.com"
    channelCustomProperties:
      - channel: "facebook"
        properties:
          top_element_style: "large"
...

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