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.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBODA0VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--94aa6ada15f0ff95078e720fa52800b6c087def3/agentbot-logic-chatwoot.png)

## 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](https://developers.chatwoot.com/api-reference/messages/create-new-message).

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](https://github.com/chatwoot/dialogflow-agent-bot-demo).

2. [Exemplo de implementação usando Rasa](https://github.com/chatwoot/rasa-agent-bot-demo).

Veja também maneiras interessantes de [aproveitar tipos de mensagens de bot no Chatwoot](https://www.chatwoot.com/docs/product/others/interactive-messages).

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUE9xVmdFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7bdf72ebbdc4c17c195f71137b30ce5f5bad5147/Screenshot%202025-05-02%20at%2010.17.45%E2%80%AFAM.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ09yVmdFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--336219625caefda41e56afd13e204a72304db075/Screenshot%202025-05-02%20at%2010.18.32%E2%80%AFAM.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSENyVmdFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--03b4d2a0fc6216c094e8374571d4b3b7b110b64a/Screenshot%202025-05-02%20at%2010.19.58%E2%80%AFAM.png)

Para mais detalhes sobre os eventos suportados nos webhooks, por favor visite a documentação de Webhook [aqui](https://www.chatwoot.com/hc/user-guide/articles/1677693021-how-to-use-webhooks).

### 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](https://www.chatwoot.com/hc/user-guide/articles/1677693021-how-to-use-webhooks#verifying-webhooks).