Como configurar e utilizar o AgentBot
Como configurar e utilizar o AgentBot
O AgentBot é um bot de atendimento que pode ser integrado às suas caixas de entrada para lidar com perguntas de clientes
automaticamente. Ele permite que você conecte sua própria lógica de bot via webhooks e APIs, além de integrar com
ferramentas como Dialogflow, Rasa ou Amazon Lex.
Como o AgentBot funciona?
Veja abaixo o fluxo típico de funcionamento de um AgentBot:
1. O sistema envia eventos de conversa para a URL do seu bot via webhooks:
- widget_triggered
- message_created
- message_updated
2. O AgentBot processa esses eventos e gera uma resposta apropriada.
3. Ele pode consultar APIs externas para obter dados (ex: status de pedido, reservas, etc.).
4. Pode utilizar serviços de NLP, como Dialogflow, Rasa ou Lex para identificação de intenção.
5. O AgentBot responde utilizando a API, como por exemplo message_create.
6. Quando necessário, o bot pode alterar o status da conversa para “aberta” para transferi-la a um agente humano.
7. Ele continua monitorando a conversa para oferecer contexto ao agente.
Como funciona a transferência entre bot e agente humano?
- Quando conectado a uma inbox, o AgentBot cria as conversas com status pendente, analisando e respondendo conforme
possível.
- Se detectar a necessidade de intervenção humana, o bot altera o status para "aberto" via API.
- Um agente humano pode, posteriormente, reenviar a conversa ao bot alterando o status de volta para "pendente",
reiniciando a lógica do AgentBot.
Casos de uso do AgentBot
Alguns exemplos de como utilizar o AgentBot na sua operação:
- Suporte com alto volume: filtrar, autenticar e responder perguntas comuns antes de escalar ao time humano.
- E-commerce: integração com banco de dados para informar status de pedidos, entregas, etc.
- Sites de conteúdo/notícias: recomendação de artigos via mensagens do tipo "card".
- Reservas de hotéis e cinema: oferecer atendimento automatizado para agendamentos e dúvidas.
Exemplos de implementação
- Exemplo de integração com Dialogflow
- Exemplo com Rasa
Como adicionar AgentBots?
Existem dois tipos de AgentBots:
- Bots Globais: com permissão para todas as contas da instalação.
- Bots por Conta: limitados à conta na qual foram criados.
Você pode criar bots por API ou via Rails Console.
Criando AgentBots via API
- Para bots globais, use os endpoints de criação de agent bots globais.
- Para bots por conta, use os endpoints específicos de cada conta.
A documentação da API está disponível em: https://www.chatwoot.com/developers/api
Criando AgentBots via Rails Console
1. Acesse o diretório e inicie o console Rails:
bundle exec rails c
1. Crie o AgentBot com a URL da sua lógica:
bot = AgentBot.create!(name: "Seu Bot", outgoing_url: "http://localhost:8000")
bot.access_token.token
1. (Opcional) Adicione um avatar ao bot:
avatar_file = Down.download("https://seusite.com/imagem.png")
bot.avatar.attach(io: avatar_file, filename: avatar_file.original_filename, content_type: avatar_file.content_type)
1. Conecte o bot a uma inbox:
AgentBotInbox.create!(inbox: Inbox.first, agent_bot: bot)
# ou para um inbox específico:
# AgentBotInbox.create!(inbox: Inbox.find(id), agent_bot: bot)
Com isso, o AgentBot já está pronto para receber eventos e responder usando sua lógica personalizada.
Se quiser, posso preparar um artigo separado detalhando como criar bots com Dialogflow ou Rasa, ou um exemplo de webhook
para autoatendimento. É só pedir!