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 conversas.

Você pode criar um bot que automaticamente postar conteúdo em grupos, responde a perguntas com informações adicionais ou age quando mencionado nos comentários de um post. 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 Postar 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 postam conteúdo novo, comentam mensagens com novas informações e curtem posts 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 conversas

Em grupos, os bots podem consumir e compartilhar informações entre um grupo de pessoas de forma assíncrona. Já em conversas, 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 conversa 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.

Conversa 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 conversa 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

Conversa bot para grupo

Os bots também podem criar, gerenciar e ser adicionados a conversas de conversa 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 conversa sobre determinados tópicos com pessoas específicas.

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

Como ativar bots para conversas em grupo

Para permitir que um bot crie conversas 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 conversas em grupo.

Ativação de um bot de integração personalizada para compatibilidade com a conversa em grupo.

Ao permitir a compatibilidade com conversas em grupo, seu bot aparecerá em digitações antecipadas para a opção Adicionar pessoas em conversas de conversa 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 uma conversa 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.

Boas práticas

Use o canal certo

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

• Se você quer um bot que interaja com várias pessoas ao mesmo tempo ou poste um conteúdo que será visualizado por diversos usuários, faz sentido criar um bot que poste em grupos e responda a comentários e menções em posts 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 app 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 posts em grupos e obter as respostas.

Interações em grupo

Depois que o app assinar os webhooks, seu bot será notificado quando for mencionado em um post ou um 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 à conversa para manter o fluxo de interação do grupo.

Caso o bot precise fornecer informações ao responsável pelo post original, inclua um comentário no próprio post para que a pessoa também seja notificada.

Interações na conversa

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.