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

Assim que um AgentBot é conectado a uma caixa de entrada, novas conversas são automaticamente atribuídas ao status *pendente*. O RockZap® 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 RockZap®.

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 RockZap®, mantendo ainda disponível a transferência para um humano quando necessário.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBd1dsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a5fcebb482c2f0189ff96c57ab88cc59bc0d10f6/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 RockZap®, 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.

## **Criando agent bots**

### **Como criar agent bots na sua conta RockZap®?**

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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBd1NsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f98f372277e075e2739c5fdba676aadf58ce1852/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBd2FsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--16e511339f902ae4433441cb752f6a639b98c82f/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBd2VsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--67fc1494f6d2617f21126beec4f584914ac11901/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.