Bots para o Workplace

Visão geral

Com as integrações personalizadas para o Workplace, agora é possível criar bots eficientes que podem interagir com pessoas em grupos e bate-papos.

Você pode criar um bot que automaticamente publica conteúdo em grupos, responde a perguntas com informações adicionais ou age quando mencionado nos comentários de uma publicação. Também é possível criar bots que conversam com as pessoas no Work Chat para fornecer informações em tempo real ou gerenciar solicitações com elementos de conversa estruturados, como respostas rápidas e menus persistentes.

Bots como páginas

No Workplace, assim como acontece na plataforma do Messenger, os bots são representados como páginas. Quando você cria um aplicativo de integração personalizada, uma página é gerada automaticamente. As pessoas da sua comunidade no Workplace podem descobrir e interagir com o bot por meio dessa página.

Os bots são representados como páginas públicas na empresa. Por isso, qualquer membro de uma comunidade do Workplace pode ver, marcar e enviar mensagens ao bot. No entanto, dependendo do nível de permissão escolhido por você durante a criação do recurso, talvez o bot não seja capaz de ver nem de interagir com todo o conteúdo no Workplace.

Por exemplo, se o bot tiver a permissão Ler o conteúdo do grupo, ele poderá ver o conteúdo nos grupos. Da mesma forma, se o bot não tiver a permissão Publicar em grupos, ele não poderá responder ao conteúdo em nenhum grupo.

Além disso, as pessoas só conseguirão encontrar seu bot e trocar mensagens no Work Chat se ele tiver a permissão Enviar mensagens para qualquer membro.

Bots em grupos

Em grupos, os bots são capazes de concluir muitas das ações realizadas por pessoas. Isso significa que você pode criar bots que publicam conteúdo novo, comentam mensagens com novas informações e curtem publicações para indicar reconhecimento ou aprovação.

Os bots também podem @mencionar pessoas para chamar a atenção e ser @mencionados para iniciar um fluxo de trabalho específico ou fazer uma pergunta.

Por fim, os bots podem assinar um grupo e @mencionar webhooks, o que permite monitorar o conteúdo e interagir com os usuários de maneiras flexíveis.

Bots em bate-papos

Em grupos, os bots podem consumir e compartilhar informações entre um grupo de pessoas de forma assíncrona. Já em bate-papos, os bots funcionam melhor para interação direta em tempo real com uma única pessoa ou um grupo definido de pessoas.

Por exemplo, um bot de bate-papo pode ser usado para enviar lembretes ou notificações importantes para alguém com base em um evento futuro, como uma entrevista ou reunião. Os bots do Work Chat também podem ser usados para engajar um usuário em uma conversa e realizar ações de acompanhamento com base no feedback recebido.

Esse modelo de interação é baseado nos mesmos conceitos usados pela plataforma do Messenger. Como resultado, os bots do Work Chat podem usar recursos como menus persistentes, respostas rápidas e modelos para aprimorar a experiência do usuário.

Bate-papo bot para usuário

Quando um bot tem a permissão Enviar mensagem para qualquer membro, ele pode enviar uma mensagem direta a qualquer pessoa no Workplace usando o endereço de email ou o ID do Workplace via API de envio do Messenger.

Um bot em uma nova digitação antecipada de mensagem

A permissão Enviar mensagem para qualquer membro também possibilita que seu bot apareça em digitações antecipadas nas plataformas de bate-papo do Workplace.

Um bot em uma nova digitação antecipada de mensagem

Ao assinar webhooks de mensagens da Página, você receberá uma notificação quando um usuário enviar uma mensagem para seu bot e poderá criar um fluxo de conversa combinando o envio e o recebimento.

Uma conversa bot para usuário

Bate-papo bot para grupo

Os bots também podem criar, gerenciar e ser adicionados a conversas de bate-papo em grupo com várias pessoas. Os bots podem criar novas conversas de grupo especificando uma lista de destinatários e renomear conversas para criar discussões de bate-papo sobre determinados tópicos com pessoas específicas.

Uma conversa nomeada com pessoas específicas, criada por um bot.

Como ativar bots para bate-papos em grupo

Para permitir que um bot crie bate-papos em grupo com usuários do Workplace, abra o painel "Permissões" do diálogo "Editar integração personalizada" e marque a caixa com o rótulo Permitir que esta integração funcione em bate-papos em grupo.

Ativação de um bot de integração personalizada para compatibilidade com o bate-papo em grupo.

Ao permitir a compatibilidade com bate-papos em grupo, seu bot aparecerá em digitações antecipadas para a opção Adicionar pessoas em conversas de bate-papo de grupos existentes. Em seguida, ele receberá webhooks para cada mensagem enviada por pessoas nessa conversa e poderá responder usando o thread ID.

Inclusão e @menção do bot em um bate-papo em grupo.

Como criar novas conversas nomeadas

Para criar uma nova conversa com destinatários específicos, faça uma solicitação POST para o ponto de extremidade /me/messages especificando uma matriz de recipient IDs e uma carga de message inicial como esta:

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

O retorno será uma carga de resposta incluindo um thread ID, que você pode usar para mensagens de acompanhamento.

Se você usar o mesmo ponto de extremidade com a mesma lista de destinatários novamente, uma nova conversa será criada. Para enviar mensagens de acompanhamento para uma conversa já criada, faça uma solicitação POST para o ponto de extremidade /me/messages usando o thread_id na carga recipient desta forma:

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

Para renomear uma conversa criada pelo seu bot, faça uma solicitação POST para a borda /{thread}/threadname desta forma:

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

É preciso usar o prefixo "t_" para o thread_id no caminho da borda

Você também pode obter a lista de participantes de uma conversa emitindo solicitações GET na borda /{thread}/?fields=participants desta forma:

GET /t_<thread_id>/?fields=participants

Também é possível adicionar e remover participantes de conversas emitindo solicitações POST ou DELETE na borda /{thread}/participants desta forma:

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

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

Parceiros de plataforma para bots

Há diversos parceiros de plataforma que oferecem suporte para bots no Workplace. Veja uma lista de parceiros aqui. Você pode usar uma dessas plataformas para criar um bot eficiente sem escrever uma única linha de código.

Melhores práticas

Use o canal certo

Ao decidir se você quer criar interações de grupo ou bate-papo, é importante considerar onde seu bot será mais útil.

• Se você quer um bot que interaja com várias pessoas ao mesmo tempo ou publique um conteúdo que será visualizado por diversos usuários, faz sentido criar um bot que publique em grupos e responda a comentários e menções em publicações de grupos.
• Caso você precise que o bot alerte sobre uma questão imediata, uma situação que pode exigir um acompanhamento rápido ou algo com que as pessoas devem interagir no modo privado, ofereça suporte a conversas no Work Chat.

Um único aplicativo pode gerenciar os dois canais. Por exemplo, pode haver casos em que o bot da Central de Suporte receberá mensagens no Work Chat e outros em que ele precisará fazer publicações em grupos e obter as respostas.

Interações em grupo

Depois que o aplicativo assinar os webhooks, seu bot será notificado quando for mencionado em uma publicação ou comentário do grupo. É importante que seu bot responda às menções com rapidez. Quando o bot precisa processar uma solicitação antes de responder, é útil curtir o comentário para informar que ele sabe que foi mencionado.

Se você estiver fornecendo informações depois de ser mencionado em um comentário, adicione uma resposta na conversa para manter o fluxo de interação do grupo.

Caso o bot precise fornecer informações ao responsável pela publicação original, adicione um comentário na própria publicação para que a pessoa também seja notificada.

Interações no bate-papo

As interações de bot no Work Chat são compatíveis com uma funcionalidade semelhante na plataforma do Messenger. Isso inclui botões de resposta rápida e modelos que ajudam a implementar árvores de decisão em conversas de bot.

Dessa forma, é possível criar fluxos de trabalho úteis e reduzir a quantidade de digitação. Além disso, como não há a necessidade do uso de um processamento de linguagem natural sofisticado, a internacionalização fica muito mais simples quando você cria bots para uma equipe global.