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. Inoltre, puoi creare 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, taggare e inviare messaggi al bot. 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 del gruppo, sarà in grado di vedere il contenuto nei gruppi. Invece, 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 in 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 funzionalità 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 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 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

Inoltre, i bot possono creare, gestire ed essere aggiunti a conversazioni in 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.

Abilitazione dei bot per le chat di gruppo

Per abilitare un bot per la creazione di chat di gruppo con utenti di Workplace, apri il pannello Autorizzazioni della finestra di dialogo Modifica integrazione personalizzata e seleziona la casella denominata Consenti a questa integrazione di funzionare nelle chat di gruppo.

Abilitazione di un bot per l'integrazione personalizzata per il supporto della chat di gruppo.

Abilitando il supporto della chat di gruppo, il tuo bot verrà visualizzato nelle anteprime 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"
}

Tieni presente la necessità di aggiungere il prefisso thread_id con "t_" nel percorso del segmento.

Inoltre, puoi ottenere la lista dei partecipanti a una conversazione emettendo richieste GET sul segmento /{thread}/?fields=participants come segue:

GET /t_<thread_id>/?fields=participants

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>]
}

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.

Interazioni con i 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.