Connettere un bot a Facebook

È possibile configurare il bot per comunicare con le persone tramite Facebook Messenger o Facebook Workplace. Questo articolo descrive come creare un'app Facebook usando il sito Meta for Developers, connettere il bot all'app Facebook in Azure e testare il bot su Facebook.

Questo articolo illustra come aggiungere il canale Facebook al bot tramite portale di Azure. Per informazioni su come usare un adattatore di canale personalizzato, vedere Informazioni aggiuntive.

Prerequisiti

• Una sottoscrizione di Azure. Se non se ne ha già uno, creare un account gratuito prima di iniziare.
• Un bot pubblicato in Azure che si vuole connettere a Facebook.
• Un account Facebook for Developers. Se non si ha un account, è possibile crearne uno in developers.facebook.com.
• Una pagina facebook da cui gli utenti accederanno al bot. Se non ne hai ancora uno, crea una nuova pagina.
• Per usare Facebook Workplace con il bot, è necessario creare un account Workplace e un'integrazione personalizzata per connettere il bot.

Creare un'app Facebook

Facebook Messenger

Gli utenti accederanno al bot da una pagina Facebook. Per connettere il bot, si abiliterà Facebook Messenger nella pagina Facebook e quindi si connetterà il bot alla pagina.

Creazione dell'app

1. Accedere all'account Meta for Developers .
2. Passare a Crea una nuova app Facebook.
3. Nella pagina Seleziona un tipo di app selezionare Business e quindi Avanti.
4. Nella pagina Fornire informazioni di base immettere un nome per l'app e selezionare Crea app.
   • Se richiesto, immettere la password e selezionare Invia per creare l'app.
   • Dopo aver creato l'app, il sito passa a una pagina per l'app.
5. Espandere Impostazioni e selezionare Basic.
   1. Copiare e salvare l'ID app e il segreto dell'app.
6. In Impostazioni selezionare Avanzate.
   1. Nel riquadro risultante scorrere verso il basso fino alle impostazioni sicurezza e abilitare Consenti l'accesso api alle impostazioni dell'app.
   2. Seleziona Salva modifiche.

Abilitare Messenger

1. Seleziona Dashboard.
2. Nel riquadro risultante scorrere verso il basso fino al riquadro Messenger e selezionare Configura.
3. Il sito aggiunge le impostazioni di Messenger all'app e visualizza la pagina delle impostazioni.

Aggiungere pagine e generare token

1. In Messenger selezionare Impostazioni.

2. Scorrere verso il basso fino a Token di accesso e selezionare Aggiungi o Rimuovi pagine.

   1. Quando viene richiesto di associare l'identità a Messenger, continuare con l'account corrente o accedere a un altro.
   2. Quando viene richiesto di specificare le pagine da usare con l'app, selezionare le pagine e quindi selezionare Avanti.
   3. Se viene richiesto di inviare la richiesta di verifica dell'accesso, esaminare le informazioni e selezionare Fine.
   4. In caso di esito positivo, il sito visualizza una pagina di operazione riuscita. Seleziona OK per continuare.

3. La pagina aggiunta viene ora visualizzata nell'elenco Pagine .

   Copiare e salvare l'ID pagina per un secondo momento.

4. Selezionare Genera token per la pagina.

   1. Il sito visualizza le informazioni di sicurezza e offre la possibilità di copiare il token.
   2. Leggere e confermare l'avviso.
   3. Copiare il token e selezionare Fine.

Sono ora disponibili le informazioni sull'app e un token per il passaggio successivo. Lasciare in sospeso i passaggi di impostazione di Facebook. Verranno aggiornati in un secondo momento.

Configurare il bot in Azure

Per consentire al bot di inviare messaggi e altri eventi a Facebook Messenger, abilitare l'integrazione dei webhook.

1. In una nuova finestra del browser passare alla portale di Azure.
2. Aprire il pannello delle risorse di Azure Bot per il bot.
3. Aprire Canali e selezionare Facebook.
4. In Configura canale Facebook immettere le informazioni di Facebook copiate nei passaggi precedenti.
   1. Immettere l'ID app Facebook e il segreto dell'app Facebook.
   2. Immettere l'ID pagina e il token di accesso.
   3. Copiare l'URL di callback generato e verificare i valori del token.
   4. Seleziona Aggiungi.

Suggerimento

• Se non si dispone di una copia delle informazioni dei passaggi precedenti, è possibile recuperarla per il sito Meta for Developers.
• Se necessario, creare un nuovo token Web per la pagina. Per istruzioni, vedere Aggiungere pagine e generare token.

Abilitare i webhook

Tornare alle impostazioni di Facebook per completare il processo di configurazione.

1. Nel sito Meta for Developers tornare alla pagina delle impostazioni di Messenger per l'app.
2. Nel riquadro risultante scorrere verso il basso fino alla sezione Webhooks e selezionare Aggiungi URL di callback.
3. Nella pagina Modifica URL callback:
   1. Immettere l'URL di callback e verificare i valori del token copiati dal portale di Azure.
   2. Selezionare Verifica e salva.
4. La pagina aggiunta viene ora visualizzata nell'elenco Pagine in Webhook.
5. Selezionare Aggiungi sottoscrizioni per la pagina.
   1. Nella pagina Modifica sottoscrizioni pagina selezionare i campi di sottoscrizione seguenti:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
   2. Seleziona Salva.
6. Il sito visualizza i campi di sottoscrizione aggiunti accanto alla pagina per il bot.

Facebook Workplace

Nota

Il 16 dicembre 2019 Workplace by Facebook ha modificato il proprio modello di sicurezza per le integrazioni personalizzate. Facebook non accetta nuove integrazioni di app per Facebook Workplace.

Rendere pubblica l'app

Fino a quando non viene pubblicata un'app, è in modalità di sviluppo. Le funzionalità dei plug-in e delle API saranno disponibili solo per amministratori, sviluppatori e tester.

Solo l'autore (l'account Di sviluppo Facebook che ha creato la pagina e il bot) può ottenere una risposta del bot. Gli utenti normali di Facebook non possono visualizzare la pagina o il bot. Assegnare ruoli di sviluppo o test agli utenti di destinazione, in modo che possano anche chattare con il bot.

Gli utenti da aggiungere ai ruoli tester devono prima registrarsi nel sito Meta for Developers. Il ruolo tester non è disponibile per gli utenti di Facebook che non hanno un account Meta for Developers. Per altre informazioni sui ruoli dell'app e sugli utenti di test, vedere la documentazione per sviluppatori Meta for Developers.

Inviare per la revisione

Facebook richiede un URL per l'informativa sulla privacy e un URL per le condizioni per l'utilizzo del servizio nella pagina delle impostazioni di base dell'app. La pagina Codice di comportamento contiene collegamenti a risorse di terze parti che consentono di creare un'informativa sulla privacy. La pagina Condizioni per l'utilizzo contiene condizioni di esempio che consentono di creare un documento di condizioni per l'utilizzo.

Dopo aver completato il bot, Facebook ha un proprio processo di revisione per le app che vengono pubblicate su Messenger. Il bot verrà testato per assicurarsi che sia conforme ai criteri della piattaforma di Facebook.

Rendere pubblica l'app e pubblicare la pagina

Quando la revisione ha avuto esito positivo, impostare l'applicazione su Pubblica nel dashboard delle app in Analisi dell'app. Accertarsi che venga pubblicata la pagina Facebook associata a questo bot. Lo stato viene visualizzato nelle impostazioni delle pagine.

Impostare la versione dell'API

Se si riceve una notifica da Facebook relativa alla deprecazione di una determinata versione dell'API Graph:

1. Passare a Meta per sviluppatori.
2. Passare all'app creata per il bot.
3. In Impostazioni selezionare Avanzate.
4. Selezionare Aggiorna versione DELL'API, quindi passare a Aggiorna tutte le chiamate alla versione 4.0.

Testare la connessione seguendo i passaggi descritti nella sezione Testare il bot in Facebook .

Testare il bot in Facebook

È ora possibile verificare se il bot è connesso correttamente a Facebook inviando un messaggio tramite la pagina Facebook associata alla nuova app Facebook.

1. Vai su Facebook e passa al profilo per la tua pagina.
2. Selezionare altre azioni (...), quindi aggiungi pulsante azione.
   1. Nella finestra di dialogo Personalizza l'azione selezionare Prova e seguire le istruzioni.
   2. Nella pagina Pulsante azione in Ottenere le persone da contattare selezionare Invia messaggio.
   3. Selezionare Avanti, completare la finestra di dialogo e salvare le modifiche.
3. Tornare al profilo personale.
4. Passare alla pagina e selezionare Messaggio per testare la connessione al bot.

È anche possibile testare questa funzionalità usando il bot di esempio per l'adapter Facebook popolando il file appsettings.json con gli stessi valori descritti nei passaggi precedenti.

Informazioni aggiuntive

Per un bot di esempio che supporta la comunicazione con Facebook Messenger, vedere l'esempio bot C# C# di Bot Framework.

Per la documentazione di Facebook Messenger, vedere:

• Documentazione della piattaforma Messenger.
• Linee guida preliminari al lancio
• Avvio rapido
• Guida all'installazione

Per la documentazione di Facebook Workplace, vedere:

• Centro assistenza di Workplace
• Documentazione per sviluppatori di Workplace