Comportamento e Coleta
As configurações de comportamento controlam como o agente coleta dados, o que acontece após completar os objetivos, e como ele se apresenta ao iniciar a conversa.Mensagem de Boas-vindas
Defina uma mensagem de abertura enviada automaticamente quando o agente inicia uma conversa.
Exemplo:
A mensagem de boas-vindas é enviada apenas quando o agente inicia a conversa — não quando o contato envia a primeira mensagem. Se o contato escrever primeiro, o agente responde normalmente sem enviar a boas-vindas.
Mensagem de Fallback
Mensagem enviada quando o agente encontra um erro ao processar a mensagem do contato (ex: falha na API do Gemini, timeout, resposta inválida). Exemplo:Comportamento Pós-Coleta
Define o que o agente faz após completar todos os objetivos (goals):Configurações de Coleta
Coleta Natural
Quando ativada, o agente coleta os dados de forma conversacional, sem parecer um formulário. Em vez de perguntar “Por favor, informe seu e-mail:”, o agente integra as perguntas naturalmente na conversa.Validar em Tempo Real
Quando ativada, o agente valida o formato dos dados no momento da coleta:- E-mails são verificados quanto ao formato
@dominio.com - Telefones são validados quanto ao formato brasileiro
Confirmação ao Final
Quando ativada, o agente resume os dados coletados ao final e pede confirmação do contato antes de marcar os objetivos como completos. Exemplo de resumo gerado:Ignorar Grupos
Quando ativado (padrão: sim), o agente não responde em grupos do WhatsApp — apenas em conversas individuais. Desative esta opção se quiser que o agente responda também em grupos (ex: grupo de suporte interno).Prioridade de Bloqueio
Quando um contato tem tanto uma tag de ativação (que ativa o agente) quanto uma tag de bloqueio (que bloqueia o agente), defina qual prevalece:
Esta configuração evita conflitos quando um contato é marcado com ambos os tipos de tags simultaneamente.
Filtro de Primeira Mensagem
Filtre a primeira mensagem recebida: o agente só inicia a conversa se a mensagem do contato contiver pelo menos uma das palavras-chave configuradas. Exemplo: se configurar as palavrasajuda, suporte, problema, o agente só inicia a conversa quando a primeira mensagem contiver uma dessas palavras — mensagens fora do contexto são ignoradas.
Após a conversa ser iniciada, o agente responde a todas as mensagens normalmente.
Recursos Úteis
Configure links e referências que o agente pode citar nas respostas. Cada recurso tem:
Os recursos são incluídos no prompt do agente, permitindo que ele referencie links relevantes durante a conversa.
Exemplo:
Variáveis Externas
Configure variáveis que são injetadas no contexto do agente via API. São úteis quando você envia dados externos (CRM, ERP) junto com a mensagem.
As variáveis externas ficam disponíveis como
collected_data quando enviadas via o endpoint process-ai-agent no campo externalContext.
Exemplo:
As variáveis externas permitem que o agente tenha contexto sobre o cliente antes de iniciar a conversa. Isso é especialmente útil para agentes de cobrança, suporte personalizado e vendas consultivas.