Sempre incluir seção de Campos Personalizados ao final do espelho. Campos devem refletir apenas o que o agente realmente coleta — nunca depender de preenchimento manual.

Etiquetas sempre ao final de cada espelho, correspondentes às 1 ou 2 perguntas iniciais do agente.

A situação deve descrever exatamente qual resposta, opção ou condição do cliente aciona aquela etapa. Situação vaga = IA não sabe quando executar = comportamento imprevisível.

Mensagem que deve ser enviada literalmente ao cliente vai entre aspas. Sem aspas, a IA interpreta como instrução e gera resposta livre — o cliente recebe algo diferente do que você escreveu.

É possível colocar mais de uma pergunta por mensagem, mas cada pergunta adicional aumenta o risco de alucinação. O padrão recomendado é uma pergunta por mensagem.

Decisão técnica (TRANSFER_STAGE, ASSIGN_DEPARTMENT, ADD_TAG, STOP_AGENT) é configurada nos campos de decisões inteligentes, nunca digitada no texto da mensagem. Se aparecer no conteúdo da etapa, é lixo — apagar.

Cada etapa permite apenas uma decisão de cada tipo (um funil, uma tag, uma transferência, uma ação de parar IA). Decisões disparam sempre que a etapa é ativada, independente do texto.

A decisão de parar a IA (STOP_AGENT) deve ser sempre a última na etapa. Se vier antes, pode impedir que as demais decisões (tag, movimentação, notificação) sejam executadas.

Toda etapa de transbordo precisa de TRANSFER_STAGE + ASSIGN_DEPARTMENT, seguida de etapa separada com STOP_AGENT. Conferir etapa por etapa antes de declarar pronto.

A IA tende a acompanhar e pular também. Cumprir a sequência à risca depende de como o prompt foi estruturado — não é uma trava automática do sistema. Use situações muito específicas para minimizar isso.

Criar etapa nova só quando indispensável. Etapas demais aumentam custo de manutenção. Consolidar sempre que possível — desmembrar só quando a regra de uma decisão por tipo obrigar.

Para qualquer construção de espelho: apresentar resumo das situações por etapa para aprovação antes de gerar o espelho completo. Nunca inventar situações além do que foi definido.

Sempre exportar o JSON depois de reorganizar as etapas no sistema. Exportar antes de arrastar para a ordem final faz a numeração do JSON não bater com a tela.

Quando o cliente altera algo, mapear todo o impacto antes de aplicar. Mudar um serviço pode exigir desmembrar etapas e ajustar instrução e regra ao mesmo tempo. Listar tudo que é afetado de uma vez para não gerar retrabalho.

Obrigatório vincular a instância ao agente em Configurações > WhatsApp. Ter a conexão feita não é suficiente — sem esse vínculo o agente não envia nem recebe mensagens.

Desconectar e reconectar a instância resolve.

Acontece quando o nome exibido no CRM é diferente do nome salvo no contato do celular.

Solução rápida: buscar pelos dois últimos dígitos do número.

Solução definitiva: editar nome do contato no celular para coincidir com o CRM. Ou editar direto em CRM > Lista > editar contato.

Quando um usuário é desmarcado/desvinculado sem ser excluído, as negociações e leads continuam vinculados a ele. O sistema não redistribui automaticamente.

Para dar continuidade: alterar o responsável manualmente em cada conversa afetada.

É obrigatório marcar um funil como padrão para que toda nova conversa gere automaticamente uma negociação nele. Sem funil padrão, conversas iniciadas pelo cliente não entram no CRM automaticamente.

Tempo de espera antes de processar mensagens em sequência. Aumentar quando o lead manda várias mensagens curtas seguidas e a IA responde de forma fragmentada ou alucinada.

Créditos baixos podem causar respostas erradas ou alucinação. Em caso de dúvida, acionar o suporte para recarga. Padrão atual: 50 mil créditos.

A configuração de intervenção precisa estar alinhada em dois lugares: no agente e nas configurações gerais. As duas telas precisam bater. Divergência causa comportamento inesperado.

Confirmar se o lead está de fato no funil e estágio configurados no follow-up. O sistema só envia para quem já chegou naquele estágio.

Funis com estágios de nomes iguais: identificar cada estágio pela movimentação/decisão correta — o identificador interno muda mesmo quando o nome visual é igual.

O conteúdo de regras/etapas não é preservado ao trocar de modelo. É necessário reestruturar do zero. É possível reverter para o modelo anterior para recuperar o que estava configurado.

Ao exportar e importar um Super Agente dentro de outro, o agente importado mantém o nome original — renomear manualmente depois. Após importar, revisar a ordem das decisões dentro de cada etapa.