> For the complete documentation index, see [llms.txt](https://ajudachat.hotmobile.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajudachat.hotmobile.com.br/agentbot.md).

# AgentBot

A AtendChat permite que você conecte facilmente sua lógica de bot personalizada ao tratamento de conversas por meio de APIs do AgentBot.

<figure><img src="/files/ziMb1y1qzOhHb92HkGdC" alt=""><figcaption></figcaption></figure>

Depois de conectar o bot do agente a uma caixa de entrada, todas as novas conversas criadas na sua caixa de entrada receberão inicialmente o status de 'bot'. O Chatwoot enviará cada evento de conversa para o URL do seu bot como eventos de webhook. Ao qual seu AgentBot pode reagir por meio das APIs do chatwoot.

### **Fluxo de Trabalho**

* O bot do agente conectado recebe eventos como widget acionado, mensagem criada, update de mensagem, etc, com base na ação do cliente.
* O bot do agente pode processar as informações recebidas e apresentar uma resposta.
* O bot do agente também pode contar com APIs do sistema externo para buscar informações adicionais do usuário, como status do pedido, gatilho de reserva, etc.
* O bot do agente também pode contar com serviços como rasa, dialogflow, lex etc.
* O bot do agente pode postar a resposta gerada de volta no widget chamando APIs chatwoot como message\_create
* O bot do agente pode alternar um status de conversa para abrir para transferir a conversa para um agente humano
* O bot do agente pode continuar a ouvir conversas abertas e ver se pode fornecer informações contextuais ao agente de suporte.

### **Casos de Uso**

* As empresas com consultas de suporte ao cliente de alto volume podem usar um bot para autenticar e filtrar ainda mais as consultas antes de passar para os agentes
* Os sites da Ecom podem conectar o bot ao banco de dados existente e fornecer o status do pedido/envio
* Sites de notícias/conteúdo podem aproveitar mensagens de cartão para enviar recomendações via bot
* Os sites de reservas de hotéis/filmes podem lidar com a reserva via bot

### **Exemplos de Implementação**

1. <https://github.com/chatroot/dialogflow-agent-bot-demo> : exemplo de implementação de reserva de hotel usando dialogflow
2. <https://github.com/chatwoot/rasa-agent-bot-demo> : exemplo de implementação usando rasa.
3. <https://github.com/douglara/chatwoot-botpress-bridge> : exemplo de implementação usando botpress.

> Procure maneiras interessantes de aproveitar os tipos de mensagens de bot na AtendChat.

### **Adicionando AgentBot na AtendChat**

Existem dois tipos de bots de agente na AtendChat.

1. **Bots globais** : Bots globais têm um escopo de permissão para todas as contas em uma instalação de AtendChat. Eles podem interagir com endpoints acessíveis por bot em relação a qualquer conta nessa instalação.
2. **Bots de conta** : Bots de conta têm um escopo de permissão limitado à conta para a qual o bot foi criado.

Você pode provisionar **AgentBot** na AtendChat por meio de nossa API ou usando o Rails Console.

#### Criação de bots de agente via API

1. **Bots globais** podem ser criados interagindo com as APIs do bot do agente .
2. **Bots de conta** podem ser criados interagindo com as APIs de bot de conta .