Workplace di Facebook

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

Limitazioni

Solo la lingua predefinita dell'agente è supportata da questa integrazione.

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 Dialogflow riceve messaggi dall'utente finale agendo come Workplace Webhook di Facebook.

Avvia

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. Attiva 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. Si aprirà la pagina di lavoro 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 luogo di lavoro nella finestra popup che richiede 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 dalla 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 un 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à la pagina di lavoro 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 Dialogflow tra le 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 converte alcuni messaggi di risposta avanzata in tipi di messaggi di Facebook Messenger Platform.

Risposte immagine

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

  • jpg
  • png
  • GIF statica
  • GIF animata

Risposte scheda

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

Risposte rapide

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 documentazione di riferimento sull'API Facebook Messenger.

Ad esempio:

  • Invia un link audio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Inviare 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 Workplace, ma puoi installare più agenti Dialogflow in 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 ed esegui la migrazione all'integrazione di Workplace, devi:

  1. Interrompi l'integrazione di Messenger.

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

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