Workplace di Facebook

Utilizzando l'integrazione di Dialogflow con Facebook Workplace, puoi creare un bot di Workplace from Facebook per interagire con i tuoi utenti finali.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente

Come funziona

Ecco come funziona l'integrazione:

  • Configura l'integrazione di Dialogflow e l'istanza di Workplace in modo che comunichino tra loro.
  • L'integrazione di Dialogflow invia messaggi all'utente finale utilizzando l' API Messenger di Facebook.
  • L'integrazione di Dialogflow riceve messaggi dall'utente finale fungendo da webhook di Workplace di Facebook.

Inizia

Per avviare l'integrazione:

  1. Registra un'istanza di 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 di Dialogflow ES.
    2. Fai clic su Integrazioni nel menu della barra laterale a sinistra.
    3. Fai clic su Workplace from Facebook.
    4. Fai clic su INIZIA e verrai reindirizzato a Workplace per completare l'installazione:
      • Accedi al tuo account Workplace. Per installare le integrazioni, l'account deve essere un amministratore di sistema su Workplace.
      • Fai clic su Aggiungi a Workplace nella finestra popup che ti chiede di installare l'integrazione di Dialogflow. Puoi anche personalizzare il nome del bot.

  3. Testa l'app:

    1. Vai a Workplace e accedi all'account.
    2. Trova 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 INIZIA ma non vuoi completare l'installazione su Workplace:

  1. Vai alla console di Dialogflow ES.

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

  3. Fai clic su Facebook Workplace:

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

Interrompi

Per interrompere un'integrazione installata correttamente:

  1. Vai alla console di Dialogflow ES.

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

  3. Fai clic su Facebook Workplace.

  4. Fai clic su INTERROMPI e verrai reindirizzato a Workplace per completare l'installazione:

    1. Accedi al tuo account Workplace. Per disinstallare le integrazioni, l'account deve essere un amministratore di sistema su Workplace.
    2. Trova e seleziona l'integrazione di Dialogflow dalle integrazioni installate su Workplace, 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 in tipi di messaggi della piattaforma Facebook Messenger.

Risposte con immagini

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

  • jpg
  • png
  • gif statica
  • gif animata

Risposte con schede

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

Risposte con risposte rapide

Le risposte con risposte rapide vengono inviate a Facebook Messenger come risposte rapide di Facebook Messenger.

Risposte con payload personalizzati

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

Il formato generale del payload personalizzato è il seguente:

{
  "facebook": {
    message
  }
}

Al posto di message, fornisci l'oggetto message di Facebook Messenger. Per i dettagli dell'oggetto message, consulta il riferimento dell'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 su una sola istanza di Workplace, ma puoi installare più agenti Dialogflow su una sola istanza di 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 vuoi eseguirne la migrazione all'integrazione di Workplace, devi:

  1. Interrompere l'integrazione di Messenger.

  2. Rimuovere il callback_url dall'app Facebook annullando i passaggi descritti in Configurare l'app Facebook.

  3. Avviare l'integrazione di Workplace seguendo i passaggi sopra indicati.