Criar Agente de IA

Agentes de IA conversam automaticamente com seus clientes via WhatsApp usando Google Gemini. Eles qualificam leads, coletam informações, respondem dúvidas e executam ações — de forma natural e personalizada.

Casos de Uso

Qualificação de leads (SDR): Qualificar leads com BANT antes de transferir para humano
Cobrança com CNV: Negociar débitos com comunicação não-violenta
Coleta de informações: Coletar nome, e-mail, interesse de forma conversacional
FAQ inteligente: Responder dúvidas com base em documentos (RAG)
Roteamento: Direcionar para departamento correto (comercial, suporte, financeiro)
Atendimento pós-venda: Resolver dúvidas e encaminhar problemas

Veja exemplos completos prontos para copiar em Templates de Agentes.

Passo a Passo

Acesse o painel do Agente

No dashboard, selecione a instância desejada e clique em Agente de IA no menu lateral. Depois clique em Criar Agente.

Configure a identidade

Defina a persona do agente:

Campo	Descrição	Exemplo
Nome da persona	Nome que o agente usará	”Ana”
Cargo da persona	Função que o agente representa	”Consultora Comercial”
Nome da empresa	Nome da sua empresa	”Brainchat”
Descrição da empresa	O que sua empresa faz	”Plataforma de automação para WhatsApp”
Produtos/Serviços	O que você oferece	”Plano Starter, Plano Pro, Plano Business”

Defina a missão

A missão é o objetivo principal do agente. Ela é incluída no prompt como “SUA MISSÃO” e guia todo o comportamento da conversa.Exemplos de missão:

“Qualificar leads e agendar reuniões com o time comercial”
“Facilitar a regularização de débitos com empatia e CNV”
“Resolver dúvidas e encaminhar problemas complexos para o suporte”

A missão é diferente das instruções personalizadas. A missão define o que o agente deve fazer; as instruções definem como ele deve fazer. Veja Prompt Engineering.

Escolha o tom de voz

Selecione como o agente deve se comunicar:

Tom	Descrição
Amigável	Descontraído e acolhedor
Profissional	Formal e objetivo
Casual	Informal e próximo
Técnico	Preciso e detalhado
Formal	Linguagem formal e cerimonial
Vendas	Persuasivo e orientado a resultados
Suporte	Empático e focado em resolução

Configure as prioridades de atuação

Prioridades definem em que ordem o agente deve focar seus esforços na conversa. Cada prioridade tem um nome, descrição e peso (importância relativa).Exemplo para um agente SDR:

Entender a dor do cliente (peso 3) — Identificar necessidade real antes de vender
Qualificar BANT (peso 2) — Budget, Authority, Need, Timeline
Agendar reunião (peso 1) — Só após qualificar

As prioridades são incluídas no prompt do agente e influenciam como ele direciona a conversa.

Defina os guardrails (proibições)

Guardrails são regras que o agente nunca deve violar. São incluídos no prompt como proibições explícitas.Exemplos:

“Nunca fornecer preços ou descontos”
“Nunca prometer funcionalidades que não existem”
“Nunca compartilhar dados de outros clientes”
“Nunca ameaçar ou usar linguagem coercitiva”

Cada guardrail é uma frase curta e direta.

Defina os objetivos (goals)

Configure quais informações o agente deve coletar durante a conversa. Cada objetivo tem:

Campo	Descrição
Nome	Identificador do campo (ex: `nome`, `email`)
Label	Nome amigável exibido (ex: “Nome completo”)
Tipo	Tipo de dado (veja tabela abaixo)
Obrigatório	Se o campo é obrigatório para completar o objetivo
Descrição	Contexto para o agente sobre como coletar
Opções	Para tipos `select` e `radio`, as opções disponíveis (formato `{value, label}`)
Lista interativa	Quando ativado, envia as opções como lista interativa do WhatsApp
Campo automático	Preenche automaticamente com dados do contato

Tipos de campo disponíveis

Tipo	Descrição	Exemplo
`text`	Texto livre	Nome, empresa
`textarea`	Texto longo	Descrição do problema
`email`	E-mail com validação	joao@empresa.com
`phone`	Telefone com validação	(11) 99999-0000
`number`	Valor numérico	Orçamento, quantidade
`select`	Escolha única entre opções	Interesse: Plano A, Plano B
`radio`	Escolha única (visual diferente)	Prioridade: Alta, Média, Baixa
`checkbox`	Múltipla escolha	Funcionalidades desejadas
`boolean`	Sim ou Não	Confirma os dados?
`date`	Data	Data de nascimento
`time`	Horário	Horário preferido
`file`	Arquivo/documento	Comprovante
`interactive_list`	Lista interativa do WhatsApp	Menu de opções

Campos automáticos (auto-preenchimento)

Alguns campos podem ser preenchidos automaticamente sem precisar perguntar ao cliente:

Fonte automática	O que preenche
`whatsapp_phone`	Número de telefone do contato
`contact_name`	Nome do contato (se já registrado)
`contact_email`	E-mail do contato (se já registrado)

Quando um campo é marcado como automático, o agente não pergunta essa informação — ela é preenchida automaticamente a partir dos dados do contato.

Exemplo de goals (formato real)

[
  {
    "id": "1",
    "name": "nome",
    "label": "Nome completo",
    "type": "text",
    "required": true,
    "description": "Nome completo do lead"
  },
  {
    "id": "2",
    "name": "email",
    "label": "E-mail",
    "type": "email",
    "required": true
  },
  {
    "id": "3",
    "name": "telefone",
    "label": "Telefone",
    "type": "phone",
    "required": true,
    "isAutomatic": true,
    "autoSource": "whatsapp_phone"
  },
  {
    "id": "4",
    "name": "interesse",
    "label": "Interesse",
    "type": "select",
    "required": false,
    "useInteractiveList": true,
    "options": [
      { "value": "starter", "label": "Plano Starter" },
      { "value": "pro", "label": "Plano Pro" },
      { "value": "business", "label": "Plano Business" }
    ]
  },
  {
    "id": "5",
    "name": "confirma",
    "label": "Confirma os dados?",
    "type": "boolean",
    "required": true
  }
]

O agente coleta essas informações de forma conversacional, sem parecer um formulário.

Ative o agente

Após configurar, ative o agente. Ele começará a responder automaticamente às mensagens recebidas na instância.

Configurações Avançadas

Configuração	Padrão	Descrição
Modelo	Gemini 2.0 Flash	Modelo de IA utilizado. Veja Modelos Disponíveis
Max Tokens	500	Tamanho máximo da resposta
Temperatura	0.7	Criatividade (0 = preciso, 1 = criativo)
Nível de raciocínio	Desativado	Controla o thinking do modelo (`desativado`, `baixo`, `médio`, `alto`) — veja Modelos
Delay de resposta	3000ms	Simula digitação para anti-ban
Histórico	10 mensagens	Quantas mensagens anteriores considerar
Nível de humanização	50%	Veja detalhes abaixo
Ignorar grupos	Sim	Quando ativado, o agente não responde em grupos do WhatsApp
Horário de funcionamento	Desativado	Quando ativado, define horário de início e fim
Mensagem fora do horário	—	Mensagem automática quando o agente está fora do expediente
Mensagem de fallback	—	Mensagem enviada quando o agente não consegue processar (erro de API, timeout, etc.)
Prioridade multi-agente	0	Quando há múltiplos agentes na instância, define qual tem prioridade (maior = mais prioritário)

Nível de Humanização

O slider de humanização controla o quão “humano” o agente parece nas respostas:

Faixa	Comportamento
0-25% (Robótico)	Respostas diretas, sem emojis, linguagem precisa
26-50% (Equilibrado)	Tom natural mas profissional, poucos emojis
51-75% (Humano)	Linguagem informal, emojis moderados, pausas naturais
76-100% (Muito humano)	Gírias leves, emojis frequentes, erros de digitação simulados

Modo de Ativação

O agente pode ser ativado de diferentes formas:

Modo	Descrição
Sempre	Responde a todas as mensagens recebidas (padrão)
Por tag	Só ativa para contatos que possuem uma tag específica
Novos contatos	Só ativa para contatos que acabaram de ser criados
Manual	O agente não ativa automaticamente — só responde quando ativado manualmente no chat

Tags de Bloqueio

Você pode configurar tags que bloqueiam o agente. Contatos com essas tags não serão atendidos pelo agente, útil para clientes em atendimento humano exclusivo ou contatos VIP.

Mascaramento de Dados (LGPD)

Configure regras de mascaramento para proteger dados sensíveis nos logs e históricos:

CPF: Mascara automaticamente números de CPF
Cartão de crédito: Mascara números de cartão
Personalizado: Defina regex para mascarar outros padrões

Os dados originais são coletados normalmente nos goals, mas ficam mascarados nos logs de conversa.

Comportamento Pós-Coleta e Mensagem de Boas-vindas

Configure o que acontece após o agente completar todos os objetivos e a mensagem enviada ao iniciar uma conversa. Veja Comportamento e Coleta.

O agente convive com o atendimento humano. Quando um operador envia uma mensagem manual, o agente pausa automaticamente. Veja Intervenção Humana.

​Criar Agente de IA

​Casos de Uso

​Passo a Passo

​Tipos de campo disponíveis

​Campos automáticos (auto-preenchimento)

​Exemplo de goals (formato real)

​Configurações Avançadas

​Nível de Humanização

​Modo de Ativação

​Tags de Bloqueio

​Mascaramento de Dados (LGPD)

​Comportamento Pós-Coleta e Mensagem de Boas-vindas

Criar Agente de IA

Casos de Uso

Passo a Passo

Tipos de campo disponíveis

Campos automáticos (auto-preenchimento)

Exemplo de goals (formato real)

Configurações Avançadas

Nível de Humanização

Modo de Ativação

Tags de Bloqueio

Mascaramento de Dados (LGPD)

Comportamento Pós-Coleta e Mensagem de Boas-vindas