Skip to main content

​
Funções e Ações do Agente

Ações são tarefas que o agente executa automaticamente durante a conversa. Quando um gatilho é ativado, o agente realiza a ação configurada.

​
Tipos de Ações

Webhook

Envia dados para um sistema externo via HTTP (CRM, ERP, planilha, etc.)

Requisição HTTP

Faz uma chamada HTTP personalizada e pode usar a resposta no contexto da conversa

Marketplace

Executa uma integração do Marketplace de apps conectados

Enviar WhatsApp

Envia uma mensagem WhatsApp para outro número (ex: notificar o vendedor)

Enviar E-mail

Envia um e-mail com os dados coletados (para, cc, cco, assunto e corpo configuráveis)

Aplicar Tag

Aplica uma etiqueta ao contato para segmentação

Remover Tag

Remove uma etiqueta do contato

Transferir p/ Agente

Transfere a conversa para outro agente de IA

Follow-Up

Agenda mensagens de acompanhamento automáticas após inatividade

Pausar Agente

Pausa o agente por um período configurável (em minutos)

​
Gatilhos (Triggers)

Cada ação tem um gatilho que define quando ela será executada:
GatilhoDescriçãoExemplo
Palavra-chaveAtivada por palavras específicas”comercial”, “vendas”, “comprar”
IntençãoIA interpreta a intenção do usuário”O usuário quer falar com um humano”
Objetivo completoQuando um goal é atingidoApós coletar nome + e-mail
Mudança de dadoQuando um campo coletado mudaQuando o e-mail é atualizado
SempreExecuta em toda mensagemLogging, analytics
AgendadoExecuta após um tempo programadoFollow-up após 24h

​
Configurar uma Ação

1

Acesse as Ações do Agente

Em Agente de IA → Ações, clique em Nova Ação.
2

Defina nome e gatilho

Dê um nome descritivo (ex: “Enviar lead para CRM”) e selecione o tipo de gatilho.
3

Configure a ação

Para Webhook, informe:
  • URL de destino
  • Método HTTP (POST, GET, PUT, PATCH, DELETE)
  • Headers personalizados
  • Template do payload com variáveis dinâmicas

​
Variáveis Disponíveis nos Templates

Use estas variáveis nos templates de payload, mensagem ou e-mail. Todas usam o prefixo _ para variáveis do sistema:

​
Variáveis do Sistema

VariávelDescrição
{{_phone}}Número do cliente
{{_contact_name}}Nome do contato
{{_collected_data}}Resumo de todos os dados coletados
{{_conversation_id}}ID da conversa
{{_agent_id}}ID do agente
{{_instance_id}}ID da instância

​
Variáveis de Dados Coletados

Cada campo configurado nos goals pode ser acessado diretamente pelo nome:
VariávelDescrição
{{nome}}Valor do campo “nome” coletado
{{email}}Valor do campo “email” coletado
{{interesse}}Valor do campo “interesse” coletado
As variáveis de dados coletados usam exatamente o name configurado no goal. Variáveis do sistema usam o prefixo _ para evitar conflitos.

​
Exemplo: Enviar Lead para Webhook

{
  "nome": "Enviar lead para CRM",
  "trigger_type": "goal_complete",
  "trigger_goal_id": "collect_email",
  "action_type": "webhook",
  "webhook_url": "https://meu-crm.com/api/leads",
  "webhook_method": "POST",
  "webhook_payload_template": {
    "nome": "{{nome}}",
    "email": "{{email}}",
    "telefone": "{{_phone}}",
    "contato": "{{_contact_name}}",
    "origem": "whatsapp-brainchat",
    "dados": "{{_collected_data}}"
  }
}

​
Opções Avançadas

OpçãoDescrição
Permitir repetiçãoPermite que a ação execute mais de uma vez na mesma conversa
Usar resposta no contextoPara Requisição HTTP: inclui a resposta da API no contexto do agente
CondiçõesRegras condicionais para executar a ação (campo X = valor Y)
PrioridadeOrdem de execução quando múltiplas ações disparam ao mesmo tempo