> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Ações do agente

> O que o agente faz sozinho durante a conversa: transferir, aplicar etiqueta, agendar, enviar para outro sistema e mais.

Ações são tarefas que o agente executa quando um gatilho acontece. Configure na aba **Ações** do construtor.

![Aba Ações do agente com o botão Adicionar Ação](https://mintcdn.com/stegia/H1B-GpiWPsLe8SyG/images/atendimento/agente-acoes.png?fit=max\&auto=format\&n=H1B-GpiWPsLe8SyG\&q=85\&s=318a94eee0e448318c1b39d7a7c1b722)

Aba Ações do construtor

## Tipos de ação

| Ação | O que faz |
| - | - |
| **Transferir p/ Humano** | Passa a conversa para a equipe. Escolha **Atribuir para (atendente)**, um departamento ou **Deixar na fila (não atribuir a ninguém)** |
| **Transferir p/ Agente** | Passa para outro agente, no mesmo número ou **Pelo número do agente destino**, com **Briefing interno para o próximo agente** |
| **Pausar Agente** | O agente para de responder nesta conversa por um tempo (opcional) |
| **Concluir atendimento** | Encerra o atendimento com mensagem final opcional |
| **Follow-Up** | Mensagens de acompanhamento quando o cliente some, com **Encerrar após o último aviso (horas)** |
| **Aplicar Tag** / **Remover Tag** / **Aplicar/remover etiqueta** | Organiza o contato com etiquetas |
| **Agendar reunião** | Marca um horário na [Agenda](https://docs.brainchat.app/captacao/agenda.md) |
| **Enviar WhatsApp** | Manda uma mensagem para outro número (ex.: avisar o vendedor) |
| **Enviar Email** | Envia um e-mail com os dados coletados |
| **Webhook** | Envia os dados para o seu sistema (CRM, ERP, planilha) |
| **Requisição HTTP** | Chama uma API e pode **Usar resposta no contexto** da conversa |
| **Marketplace** | Usa uma integração conectada, como o Pipefy |

## Quando executar

Em **Quando executar esta ação**, escolha o gatilho:

| Gatilho | Exemplo |
| - | - |
| **Quando goals completados** | Depois de coletar nome e e-mail |
| **Quando dado coletado** | Ao receber o CPF |
| **Quando palavra-chave detectada** | "falar com atendente", "cancelar" |
| **Quando intenção detectada** | "O cliente quer falar com um humano" |
| **Sempre (a cada mensagem)** | Registro em outro sistema |

## Opções

* **Exigir confirmação do cliente** antes de executar.
* **Permitir execução múltipla**: desligado, executa só uma vez por conversa.
* **Verificar duplicidade** (em Webhook, Requisição HTTP e Marketplace), com **Chave de deduplicação**.
* **Anexar arquivos coletados**.
* **Após o sucesso desta ação**: **Continuar respondendo**, **Parar de responder**, **Concluir o atendimento**, **Reiniciar coleta** ou **Executar ação na sequência**.
* **Papel no encerramento**: **Não interfere**, **Obrigatória antes de encerrar** ou **Conclui o atendimento**.

## Variáveis

Use variáveis no conteúdo das mensagens, e-mails e no corpo (JSON) de Webhook e Requisição HTTP:

| Variável | Valor |
| - | - |
| `{{_phone}}` | Telefone do contato |
| `{{_contact_name}}` | Nome do contato |
| `{{_collected_data}}` | Todos os dados coletados |
| `{{_goals_completed}}` | Itens da coleta já concluídos |
| `{{_message}}` | Mensagem atual do cliente |
| `{{_conversation_id}}` | ID da conversa |
| `{{_timestamp}}` | Data e hora atual |
| `{{nome_do_campo}}` | Qualquer campo da **Coleta de Dados**, pelo nome configurado |

### Exemplo de corpo de webhook

```json theme={null}
{
  "nome": "{{nome}}",
  "email": "{{email}}",
  "telefone": "{{_phone}}",
  "origem": "whatsapp-brainchat",
  "dados": "{{_collected_data}}"
}
```

> [!TIP]
>
> Toda conversa precisa de uma saída para a equipe: crie pelo menos uma ação **Transferir p/ Humano** e use-a também em **Se o agente falhar**, nas Configurações Iniciais.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.