Workplace di Facebook

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Grazie all'integrazione di Dialogflow Facebook Workplace, puoi creare un bot di Facebook per interagire con gli utenti finali.

Nota: quando utilizzi un'integrazione di terze parti, le richieste e i dati degli utenti finali vengono inviati sia a Google che alla terza parte. I termini di servizio, lo SLA (accordo sul livello del servizio), i prezzi e le quote per la versione dell'agente si applicano alla gestione di queste richieste da parte di Google. I termini di servizio, lo SLA (accordo sul livello del servizio), i prezzi e le quote della terza parte si applicano alla gestione di queste richieste da parte della terza parte.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente.

Come funziona

Ecco come funziona l'integrazione:

• Puoi configurare l'integrazione di Dialogflow e l'istanza di Workplace in modo che comunichino tra loro.
• L'integrazione Dialogflow invia messaggi all'utente finale utilizzando l'API Messenger di Facebook.
• L'integrazione di Dialogflow riceve i messaggi dall'utente finale agendo come Webhook di Workplace di Facebook.

Inizio

Per avviare l'integrazione:

1. Registra un'istanza Workplace se non ne hai una e assicurati di essere l'amministratore di sistema del gruppo.

2. Abilita l'integrazione dalla console di Dialogflow:

   1. Vai alla console Dialogflow ES.
   2. Fai clic su Integrazioni nel menu della barra laterale sinistra.
   3. Fai clic su Workplace from Facebook.
   4. Fai clic su AVVIA e si aprirà Workplace per completare l'installazione:
      • Accedi al tuo account Workplace. Per installare le integrazioni, l'account deve essere un amministratore di sistema in Workplace.
      • Fai clic su Add to Workplace (Aggiungi a luogo di lavoro) nella finestra popup che richiede di installare l'integrazione di Dialogflow. Hai anche la possibilità di personalizzare il nome del bot.

3. Testa l'app:

   1. Vai a Workplace e accedi all'account.
   2. Individua Dialogflow (o il nome personalizzato del tuo bot) in Bot nella sezione Home della barra laterale e inizia a chattare con il bot.

Annulla

Se hai fatto clic sul pulsante AVVIA, ma non vuoi completare l'installazione su Workplace:

1. Vai alla console Dialogflow ES.

2. Fai clic su Integrazioni nel menu della barra laterale sinistra.

3. Fai clic su Facebook Workplace:

   1. Se viene visualizzato il pulsante ANNULLA, fai clic su ANNULLA per annullare l'installazione.
   2. Se viene visualizzato il pulsante INTERROMPI: segui le istruzioni riportate di seguito per disinstallare l'integrazione.

Arresta

Per interrompere un'integrazione installata correttamente:

1. Vai alla console Dialogflow ES.

2. Fai clic su Integrazioni nel menu della barra laterale sinistra.

3. Fai clic su Facebook Workplace.

4. Fai clic su INTERROMPI. Si aprirà Workplace per completare l'installazione:

   1. Accedi al tuo account Workplace. Per disinstallare le integrazioni, l'account deve essere un amministratore di sistema in Workplace.
   2. Trova e seleziona l'integrazione di Dialogflow dalle integrazioni installate su Workplace, quindi fai clic su Disinstalla per completare la disinstallazione.

5. L'integrazione di Dialogflow verrà disinstallata.

Messaggi di risposta avanzati

Questa integrazione traduce alcuni messaggi di risposta avanzati nei tipi di messaggi di Facebook Messenger Platform.

Risposte immagine

Le risposte di immagini vengono inviate a Facebook Messenger come messaggi allegati a file di Facebook Messenger. Il valore message.attachment.type è impostato su image. Sono supportati i seguenti formati:

• jpg
• png
• GIF statica
• GIF animata

Risposte alle schede

Le risposte alle schede vengono inviate a Facebook Messenger come modelli generici di Facebook Messenger.

Risposte di risposta rapida

Le risposte di risposta rapida vengono inviate a Facebook Messenger come risposte rapide di Facebook Messenger.

Risposte payload personalizzate

Per inviare altri tipi di messaggi di Facebook Messenger, puoi utilizzare un payload personalizzato.

Il formato generale del payload personalizzato è simile al seguente:

{
  "facebook": {
    message
  }
}

Al posto di message, fornisci l'oggetto message di Facebook Messenger. Per i dettagli dell'oggetto message, consulta la pagina di riferimento sull'API Facebook Messenger.

Ad esempio:

• Invia un link audio:

  {
    "facebook": {
      "attachment": {
        "type": "audio",
        "payload": {
          "url": "https://example.com/audio/test.mp3"
        }
      }
    }
  }
      

• Invia un video riproducibile:

  {
    "facebook": {
      "attachment": {
        "type": "video",
        "payload": {
          "url": "https://example.com/video.mp4"
        }
      }
    }
  }
      

• Invia un file:

  {
    "facebook": {
      "attachment": {
        "type": "file",
        "payload": {
          "url": "https://example.com/file.pdf"
        }
      }
    }
  }
      

Limitazioni

1. Un agente Dialogflow può essere installato solo su un'istanza Workplace, ma puoi installare più agenti Dialogflow su una sola istanza Workplace.

2. Per rimuovere un'installazione non riuscita, devi annullare l'installazione su Dialogflow e rimuovere l'installazione su Workplace.

Migrazione

Se utilizzi l'integrazione di Messenger e ne esegui la migrazione all'integrazione in Workplace, devi:

1. Interrompi l'integrazione di Messenger.

2. Rimuovi callback_url dall'app Facebook invertendo i passaggi in Configurazione dell'app Facebook.

3. Avvia l'integrazione di Workplace seguendo i passaggi precedenti.