Workplace di Facebook

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

Limitazioni

Solo il lingua predefinita dell'agente è supportato da questa integrazione.

Come funziona

Ecco come funziona l'integrazione:

  • Configuri l'integrazione di Dialogflow e l'istanza di Workplace, in modo che possano comunicare tra loro.
  • L'integrazione di Dialogflow invia messaggi all'utente finale utilizzando API Messenger di Facebook.
  • L'integrazione di Dialogflow riceve messaggi dall'utente finale agendo come Workplace Webhook 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 Dialogflow:

    1. Vai alla console Dialogflow ES.
    2. Fai clic su Integrations (Integrazioni) nel menu della barra laterale sinistra.
    3. Fai clic su Workplace from Facebook.
    4. Fai clic su INIZIA. Si aprirà 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 la tua app:

    1. Vai a Workplace e accedi all'account.
    2. Individua 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 Integrations (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.

Interrompi

Per interrompere un'integrazione installata correttamente:

  1. Vai alla console Dialogflow ES.

  2. Fai clic su Integrations (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 tra le integrazioni installate su Workplace e fai clic su Disinstalla per completare la disinstallazione.

  5. L'integrazione di Dialogflow verrà disinstallata.

Messaggi di risposta avanzati

Questa integrazione traduce messaggi di risposta avanzata messaggi a Tipi di messaggi della piattaforma Facebook Messenger

Risposte immagine

Risposte tramite immagini vengono inviati a Facebook Messenger come Messaggi di file allegati di Facebook Messenger. Il valore di message.attachment.type è impostato su image. Sono supportati i seguenti formati:

  • jpg
  • png
  • gif statica
  • gif animata

Risposte delle schede

Risposte delle schede vengono inviati a Facebook Messenger come Modelli generici di Facebook Messenger.

Risposte rapide

Risposte rapide vengono inviati 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 ha il seguente aspetto:

{
  "facebook": {
    message
  }
}

Al posto di message, fornisci l'oggetto message di Facebook Messenger. Per maggiori dettagli sull'oggetto message, consulta Riferimento 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 solo su un'istanza di Workplace, ma puoi installare più agenti Dialogflow in un'unica istanza di Workplace.

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

Migrazione

Se utilizzi l'integrazione di Messenger e vuoi eseguirne la migrazione all'integrazione di Workspace, devi:

  1. Interrompi l'integrazione di Messenger.

  2. Rimuovi il callback_url sull'app di Facebook invertendo i passaggi descritti in Configurare l'app Facebook.

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