Pranav

Pranav

Última atualização em Jun 3, 2026

AgentBot permite que você conecte agentes de IA externos e lógica de bot personalizada diretamente à sua caixa de entrada do Chatwoot. Ele permite que seu bot ouça as conversas dos clientes, processe consultas recebidas e responda através do Chatwoot em tempo real.

Assim que um AgentBot é conectado a uma caixa de entrada, novas conversas são automaticamente atribuídas ao status pendente. O Chatwoot então envia eventos de conversa para a URL do seu bot configurado como eventos webhook. Seu AgentBot pode processar esses eventos, gerar a resposta adequada usando sua própria lógica ou sistemas de IA e enviar mensagens de volta para a conversa usando as APIs do Chatwoot.

Isso facilita a integração do seu próprio agente de IA, fluxo de trabalho de automação ou bot de suporte ao cliente externo no Chatwoot, mantendo ainda disponível a transferência para um humano quando necessário.

Como o AgentBot funciona?

Explicado abaixo em um fluxo de trabalho típico de um AgentBot.

  1. O AgentBot recebe eventos como widget_triggered, message_created e message_updated com base nas interações dos clientes.

  2. O AgentBot processa as informações recebidas para gerar uma resposta apropriada.

  3. O AgentBot também pode utilizar APIs de sistemas externos para reunir informações adicionais do cliente, como status de pedidos ou gatilhos de reservas.

  4. O AgentBot pode integrar modelos de IA como OpenAI, Claude, Gemini ou ferramentas como Amazon Lex para entender o que o cliente deseja.

  5. O AgentBot pode postar a resposta gerada de volta no widget utilizando as APIs do Chatwoot, como Criar Nova Mensagem.

  6. O AgentBot pode alternar o status de uma conversa para aberta para transferi-la para um agente humano.

  7. Ele continua monitorando conversas abertas para fornecer informações contextuais ao agente de suporte.

Como funciona a transferência para agente humano?

Quando um agent bot está conectado a uma caixa de entrada, as conversas são criadas com status "pendente", permitindo que ele faça a triagem da conversa antes de passá-la para um agente humano.

Se o bot determinar que a assistência de um agente humano é necessária ou se o cliente solicitar explicitamente ajuda humana, ele pode usar a API de atualização de conversa para alterar o status para "aberta", tornando a conversa disponível para um humano.

Às vezes os agentes vão querer devolver uma conversa que foi transferida, de volta para a fila do bot. Os agentes podem devolver uma conversa transferida para a fila do bot alterando o status de volta para “pendente”.

Como posso usar o AgentBot?

Listados abaixo estão alguns exemplos.

  1. Empresas com alto volume de consultas de suporte ao cliente podem usar um AgentBot para autenticar e filtrar pedidos, reduzindo a carga de trabalho dos agentes humanos e aumentando a eficiência do atendimento.

  2. Sites de e-commerce podem integrar o AgentBot com seus bancos de dados existentes, fornecendo aos clientes atualizações em tempo real sobre pedidos e status de envio, assim como responder a outras perguntas relacionadas.

  3. Sites de notícias e conteúdo podem usar o AgentBot para enviar recomendações aos usuários por meio de mensagens em cartão.

  4. Sites de reservas de hotéis e ingressos de cinema podem usar o AgentBot para lidar com reservas, agendamentos e responder perguntas relacionadas, proporcionando uma experiência de reserva conveniente e integrada aos clientes.

Exemplos

  1. Implementação de reserva de hotel usando Dialogflow.

  2. Exemplo de implementação usando Rasa.

Veja também maneiras interessantes de aproveitar tipos de mensagens de bot no Chatwoot.

Criando agent bots

Como criar agent bots na sua conta Chatwoot?

Você pode criar agent bots a partir das configurações da conta. Vá para Configurações -> Bots. Você verá uma opção como a exibida abaixo.

Clique em "Adicionar Bot" para criar um novo bot. Você verá uma opção para fornecer nome, avatar e uma URL de webhook.

Como conectar uma caixa de entrada a um bot?

Abra a caixa de entrada onde você quer vincular o bot. Em Configuração do Bot, escolha o bot que deve gerenciar as conversas. Depois de clicar em Salvar, você começará a receber eventos webhook toda vez que uma nova conversa ou mensagem for criada.

Para mais detalhes sobre os eventos suportados nos webhooks, por favor visite a documentação de Webhook aqui.

Verificação do Webhook

Assim que você criar um agent bot, geramos automaticamente uma chave secreta que você pode usar para verificar o payload recebido pela sua aplicação. Você pode ler mais sobre verificação de webhook aqui.