Panoramica
Un chat bot è un tipo di integrazione personalizzata con la quale gli utenti di Workplace della tua azienda possono interagire tramite Workchat. Il bot consente di automatizzare determinate azioni e accelerare alcuni processi. Questo documento descrive i casi d'uso più comuni, ma le possibilità sono infinite.
In questa sezione, scopriremo come creare un bot in 2 passaggi: la configurazione del bot su Workplace e la sua implementazione nei server.
Per ulteriori dettagli sulle integrazioni e le configurazioni in generale, consulta questa sezione.
Configurazione di un botConfigurazione di un chat bot su Workplace
Il primo passaggio per la creazione di un chat bot consiste nella sua configurazione su Workplace. Per fare ciò, accedi a Workplace come amministratore con autorizzazione a modificare le impostazioni dell'azienda e configurare le integrazioni. Una volta effettuato l'accesso, completa i passaggi seguenti:
Una volta creato il bot, puoi procedere con il resto della configurazione.
Configurazione di base
Nella sezione Integrazioni del Pannello di amministrazione, clicca sul nome del bot da configurare. Fai attenzione ai dettagli di base.
Il token sarà inviato nelle richieste API generate dal bot per consentire a Workplace di verificare che provengono dal tuo bot.
Se non è visibile, gli utenti non potranno interagirci. Puoi abilitarlo in un secondo momento durante il processo, dopo aver completato la configurazione, ma non dimenticarti di farlo prima del lancio.
Autorizzazioni
Nella schermata di configurazione dell'integrazione è presente una sezione Autorizzazioni che ti consente di scegliere le autorizzazioni necessarie per il tuo bot.
Se ti servono, puoi selezionare anche altre autorizzazioni. Ad esempio, se vuoi che il bot recuperi i profili di Workplace degli utenti, seleziona l'autorizzazione "Visualizzazione del profilo di lavoro".
Webhook
Webhook è un'altra sezione disponibile per la configurazione di un chat bot. Gli webhook ti consentono di iscriverti a eventi specifici per ricevere aggiornamenti in tempo reale. Quando si verifica una modifica o un evento in Workplace (ad esempio, quando qualcuno invia un messaggio al bot), il sistema invia una richiesta HTTPS POST per ogni app di integrazione personalizzata iscritta al relativo argomento del webhook.
Prima di proseguire con questa configurazione, assicurati di implementare il codice del bot nel tuo server web. Trovi ulteriori informazioni qui.
Questi eventi ci consentiranno di sapere quando una persona invia un messaggio al nostro bot quando questa interagisce con uno dei suoi pulsanti.
Protezione
L'ultima sezione di configurazione di un'integrazione è quella dedicata alla protezione. Sebbene questa configurazione non sia strettamente necessaria per il funzionamento del bot, ti consigliamo vivamente di effettuarla prima del lancio in produzione.
In questo modo, quando il tuo server invia le richieste API a Workplace, saranno richiesti la verifica e l'orario della chiave segreta come ulteriore forma di protezione.
Implementazione di un chat bot nel server
Il secondo passaggio per la creazione di un chat bot consiste nell'implementazione del codice del bot nel tuo server. Per fare ciò, devi implementare parte del codice in uno dei tuoi server web.
Abbiamo creato alcuni esempi di bot che puoi copiare sostituendo semplicemente i token nel codice. I bot di esempio sono disponibili ai link seguenti:
- Bot di assistenza, per automatizzare le richieste di assistenza informatica degli utenti.
- Bot di riconoscimento, per automatizzare il riconoscimento tra utenti.
- Bot per le FAQ HR, per offrire agli utenti un semplice accesso alle FAQ sulle risorse umane.