Creazione di bot per Workplace

Panoramica

Con le integrazioni personalizzate per Workplace, ora è possibile creare bot efficienti, in grado di interagire con le persone nei gruppi e nelle chat.

Puoi creare un bot che pubblichi automaticamente contenuti in gruppi, risponda alle domande con informazioni aggiuntive o esegua azioni quando viene menzionato nei commenti su un post. Puoi creare anche bot in grado di conversare con le persone in Work Chat, fornendo informazioni in tempo reale o gestendo richieste con elementi di conversazione strutturati come risposte rapide e menu always-on.

Bot come Pagine

Su Workplace, in modo simile alla piattaforma Messenger, i bot vengono rappresentati come pagine. Viene creata automaticamente una pagina quando crei un'app con integrazioni personalizzate. Le persone nella tua community di Workplace possono scoprire e interagire con il tuo bot attraverso questa pagina.

Le pagine dei bot sono pagine pubbliche dell'azienda, quindi qualsiasi membro di una community di Workplace può vedere e taggare il bot e inviargli dei messaggi. Tuttavia, a seconda del livello di autorizzazione scelto durante la creazione del tuo bot, quest'ultimo potrebbe non essere in grado di vedere e interagire con tutti i contenuti presenti su Workplace.

Ad esempio, se il tuo bot dispone dell'autorizzazione Visualizzazione dei contenuti dei gruppi, sarà in grado di vedere il contenuto nei gruppi. Se il tuo bot non dispone dell'autorizzazione Pubblicazione nei gruppi, non sarà in grado di rispondere ai contenuti di alcun gruppo.

Inoltre, le persone saranno in grado di trovare e inviare messaggi al tuo bot in Work Chat solo se dispone dell'autorizzazione Invio di messaggi a tutti i membri.

Bot nei gruppi

Nei gruppi, i bot possono svolgere molte delle attività che possono essere svolte dalle persone. Ciò significa che puoi creare bot che pubblicano nuovi contenuti, commentano i contenuti con nuove informazioni e mettono "Mi piace" ai post per indicare conferma o approvazione.

Inoltre, i bot possono @menzionare le persone per catturare la loro attenzione ed essere @menzionati per avviare un flusso di lavoro specifico o porre una domanda.

Infine, i bot possono attivare l'iscrizione al gruppo e @menzionare i webhooks che forniscono la possibilità di monitorare i contenuti e interagire con gli utenti in modi flessibili.

Bot in Chat

Mentre nei gruppi i bot sono in grado di utilizzare e condividere informazioni tra un gruppo di persone in modo asincrono, i bot in chat sono i migliori per l'interazione diretta in tempo reale con una singola persona o un gruppo definito di persone.

Ad esempio, un bot per la chat può essere utilizzato per inviare promemoria o notifiche importanti a qualcuno in base a un evento in programma come un colloquio o una riunione. Inoltre, i bot per Work Chat possono essere utilizzati per coinvolgere un utente in una conversazione e intraprendere azioni di follow-up in base al feedback ricevuto.

Questo modello di interazione si basa sugli stessi concetti utilizzati dalla Piattaforma Messenger. Di conseguenza, i bot per Work Chat possono utilizzare funzioni come menu always-on, risposte rapide e modelli per arricchire l'esperienza utente.

Chat da bot a utente

Quando un bot dispone dell'autorizzazione Invio di messaggi a tutti i membri, può inviare un direct a qualsiasi persona su Workplace mediante l'indirizzo e-mail o l'ID Workplace con l'API Messenger Send.

Un bot nell'anteprima di digitazione di un nuovo messaggio

Inoltre, l'autorizzazione Invio di messaggi a tutti i membri, consente al tuo bot di essere visualizzato nelle piattaforme di Workplace Chat.

Un bot nell'anteprima di digitazione di un nuovo messaggio

Attivando l'iscrizione ai webhooks dei messaggi della Pagina, quando un utente invia un messaggio al tuo bot, questo riceverà una notifica; inoltre, potrai creare un flusso di conversazione combinando l'invio e la ricezione.

Una conversazione da bot a utente

Chat da bot a gruppo

Quando un bot dispone delle autorizzazioni Invio di messaggi a tutti i membri e Bot per la chat di gruppo, può creare, gestire ed essere aggiunto a conversazioni di chat di gruppo con più persone. I bot possono creare nuove conversazioni di gruppo specificando una lista di destinatari e possono rinominare le conversazioni per creare discussioni in chat su argomenti specifici con determinate persone.

Una conversazione a cui è stato assegnato un nome con persone specifiche, creata da un bot.

Abilitando il supporto della chat di gruppo, il tuo bot verrà visualizzato nelle anteprime di digitazione Aggiungi persone nella conversazione di una chat di gruppo esistente. Riceverà quindi webhooks per ogni messaggio inviato da persone presenti in quella specifica conversazione, con la possibilità di rispondere alla suddetta conversazione utilizzando il proprio thread ID.

Aggiunta di un bot a una chat di gruppo, quindi @menzione del bot

Creazione di nuove conversazioni a cui è stato assegnato un nome

Per creare una nuova conversazione con destinatari specifici, effettua una richiesta POST all'endpoint /me/messages specificando un array di recipient IDs e un payload message iniziale come segue:

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

Riceverai un payload di risposta che include un thread ID, che puoi utilizzare per i messaggi di follow-up.

Verrà creata una nuova conversazione se utilizzi nuovamente lo stesso endpoint con la stessa lista di destinatari. Per inviare messaggi di follow-up a una conversazione già creata, effettua una richiesta POST all'endpoint /me/messages utilizzando thread_id nel payload recipient come segue:

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

Per rinominare una conversazione creata dal tuo bot, effettua una richiesta POST al segmento /{thread}/threadname come segue:

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

Ricorda che è necessario aggiungere il prefisso thread_id con "t_" al percorso del segmento.

Puoi anche aggiungere e rimuovere partecipanti dalle conversazioni emettendo richieste POST o DELETE sul segmento /{thread}/participants come segue:

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

Menzione in una conversazione

Quando il tuo bot viene menzionato in un messaggio, i nostri webhook invieranno la lista dei membri taggati in quel messaggio specifico, come il seguente payload:

{
    "object":"page",
    "entry":[{
        "id":"746230239054322",
        "time":1539281406974,
        "messaging":[{
            ...
            "message":{
                "mid":"<message id>",
                "seq":2192,
                "text":"@Edu Gomes @Example Bot What's 2+2?"
            },
            "mentions":[{
                "offset":0,
                "length":10,
                "id":"100017376437045"
            },
            {
                "offset":11,
                "length":12,
                "id":"746230239054322"
            }]
        }]
    }]
} 

Partner della piattaforma di bot

Workplace ha una serie di partner della piattaforma di bot che hanno creato il supporto per i bot su Workplace. Puoi anche vedere una lista di questi ultimi qui. Puoi utilizzare una di queste piattaforme per creare un bot efficace senza scrivere una sola riga di codice.

Best practice

Utilizzo del canale giusto

Quando decidi se creare interazioni di gruppo o chat per il tuo bot, è opportuno prendere in considerazione dove il tuo bot sarà più utile.

• Se stai creando un bot con cui più persone potrebbero interagire contemporaneamente o un bot che pubblica contenuti che possono essere visualizzati da più persone, può risultare utile creare un bot che pubblichi nei gruppi e risponda a commenti e menzioni sui post nei gruppi.
• Se stai creando un bot che deve avvisare qualcuno di qualcosa di immediato, qualcosa che potrebbe richiedere un rapido follow-up o qualcosa con cui le persone dovrebbero interagire in privato, devi supportare le conversazioni in Work Chat per il tuo bot.

Un'unica app può gestire entrambi i canali. Potrebbero esserci momenti in cui, ad esempio, il bot dell'assistenza riceve messaggi in Work Chat e altre volte in cui deve pubblicare nei gruppi e raccogliere le risposte.

Deep link ai bot

Utilizza il formato del link https://w.m.me/{page-id} per il collegamento diretto a un bot per la chat su Workplace. Al momento, l'assistenza è disponibile su Workplace Chat quando utilizzi web, Android e iOS. Nelle piattaforme mobili in cui è installata l'app Workplace Chat, il link si aprirà direttamente nell'app.

Parametri di reindirizzamento

Per incorporare ulteriori informazioni nel link può essere utilizzato anche un parametro di reindirizzamento. Ad esempio, ciò potrebbe consentire al bot di eseguire azioni personalizzate in base all'utente su cui l'utente ha cliccato per arrivare al bot.

Per utilizzare questa funzione, usa il formato del link https://w.m.me/{page-id}?ref={referral_parameter}. Questa funzione viene implementata nello stesso modo della piattaforma Messenger. Consulta la documentazione su Messenger per i dettagli.

Il campo del webhook pertinente è messaging_referrals e richiede un nuova iscrizione. In precedenza, questo campo del webhook disponibile per le app Workplace non era disponibile, ma ora potrai attivare l'iscrizione come al solito.

Il payload del webhook è nello stesso formato di Messenger, con le solite differenze: Workplace utilizza ID per singola app, non ID per singola pagina. Inoltre, Workplace fornisce anche un campo della community nel webhook, che contiene l'ID della community.

Interazioni nei gruppi

Una volta che per la tua app è stata attivata l'iscrizione ai webhooks, il tuo bot riceverà una notifica quando viene menzionato in un post di gruppo o in un commento. È importante che il tuo bot risponda alle menzioni in modo tempestivo. Se il tuo bot deve elaborare una richiesta prima di rispondere, è utile mettere "Mi piace" al commento, per indicare alla persona che il bot sa di essere stato menzionato.

Quindi, quando fornisci informazioni dopo essere stato menzionato in un commento, aggiungi una risposta in sequenza per mantenere il flusso del resto della conversazione di gruppo.

Se il tuo bot ha bisogno di fornire informazioni all'autore del post originale, aggiungi un commento sul post stesso, in modo che anche quest'ultimo riceva una notifica.

Interazioni con le chat

Le interazioni con i bot in Work Chat supportano funzionalità simili alla piattaforma Messenger. In tale ambito sono inclusi pulsanti e modelli di risposta rapida utili per implementare alberi di decisione nelle conversazioni dei bot.

Ciò semplifica notevolmente la creazione di flussi di lavoro utili e riduce la quantità di parole che devono essere digitate dalle persone, senza la necessità di sofisticate elaborazioni del linguaggio naturale, il che semplifica notevolmente anche l'internazionalizzazione se stai creando bot per una forza lavoro globale.