Facebook Messenger

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 l'app Facebook che utilizzerai per il canale:
   1. Nel browser, è possibile andare all'indirizzo https://developers.facebook.com/apps/.
   2. Selezionare la scheda Applicazioni personali e fare clic su Crea applicazione.
   3. Nella pagina Dettagli applicazione della Creazione guidata applicazione immettere il nome che si desidera utilizzare per l'applicazione e l'indirizzo di posta elettronica che si desidera utilizzare come contatto per l'applicazione. Quindi fare clic su Successivo.
   4. Nella pagina Casi d'uso, in Filtra per, selezionare Messaggio aziendale. Quindi selezionare Coinvolgi con i clienti su Messenger da Meta e fare clic su Successivo.
   5. Fare clic sulle altre pagine della procedura guidata, quindi fare clic su Panoramica nella pagina Crea applicazione.
3. Una volta creata l'applicazione, selezionarla (sul lato sinistro della pagina Applicazioni personali), quindi, nella sezione Impostazioni applicazione, selezionare Base.
4. Copiare il valore del campo Segreto applicazione e incollarlo in un formato appropriato nel sistema.

   Avrai bisogno del segreto app in un secondo momento per completare la configurazione del tuo canale Facebook.

5. Nella sezione Pagina Applicazione fare clic su Crea nuova pagina.
6. Nella pagina Crea pagina, compilare i campi obbligatori, quindi fare clic su Crea pagina.
   Nota
   
   Il nome della pagina deve contenere il nome dell'applicazione.
7. Generare un token di accedere:
   1. Selezionare Tools > Graph API Explorer.
   2. Nella sezione Token di accesso della pagina, selezionare il nome dell'app in App Meta.
   3. Per il campo Utente o pagina, selezionare Recupera token.
   4. Nella sezione Autorizzazioni fare clic su Aggiungi un'autorizzazione e selezionare le autorizzazioni riportate di seguito.
      • business_management
      • pages_manage_metadata
      • pages_messaging
      • pages_show_list
   5. Fare clic su Genera token di accesso.
8. 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.

In Facebook Messenger, definire l'URL di callback utilizzando l'URL del webhook generato da Digital Assistant nel passo precedente.

1. Nella console di Facebook Messenger, vai al progetto che hai inizialmente creato per il webhook.
2. Selezionare Impostazioni API Messenger per aprire la pagina Impostazione API Messenger.
3. Nel campo URL richiamata incollare l'URL del webhook ottenuto dalla pagina Canali di Digital Assistant.
4. Nel campo Verifica token della console Messenger incollare il token di verifica dalla pagina Canali di Digital Assistant.
5. Nella sezione Campi webhook, selezionare gli eventi di callback messages e messaging_postbacks.
6. Fare clic su Verifica e salva.
7. Iscriviti alla pagina:
   1. Nella sezione Genera token di accesso della pagina Impostazione API Messenger, selezionare la pagina Facebook per il canale.
   2. Fare clic su Aggiungi sottoscrizione.
   3. Nella finestra di dialogo Modifica sottoscrizioni pagina, verificare che siano selezionati messaggi e messaging_postbacks e fare clic su Conferma.

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 il Canale di Facebook e la configurazione di 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 dispositivo.

1. Andare a https://www.messenger.com/.
2. Nell'interfaccia di Messenger, immettere il nome della pagina da cercare.
3. Inizia a chattare con il tuo assistente digitale (o abilità autonoma).

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'illustrazione persist-menu1.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.