Gatilho: Contato criado

O que é

Dispara sempre que um contato novo é criado na Omnifox — manualmente, via API, importação em massa, uma mensagem recebida ou o widget de webchat.

Quando usar

• Sequências de boas-vindas automáticas para leads novos.
• Marcar contatos e depois checar a origem real na ficha do contato.
• Sincronizar o contato com um CRM externo via webhook de saída.

Requisitos

• Pelo menos um canal ou formulário que gere contatos.
• Workflows habilitado.

Variáveis disponíveis

• $contact.id, first_name, last_name, display_name, email, phone, company, job_title, city, country, tags
• $contact.source — ⚠️ hoje só pode valer user, system, api ou customer_reply; nunca assume os valores manual, import, whatsapp_incoming ou webchat_signup/contact_merge, mesmo que o filtro os ofereça como opção. Na prática, um contato criado por uma mensagem recebida do WhatsApp costuma chegar como system (não whatsapp_incoming). A origem real e detalhada do contato (WhatsApp, importação, API etc.) fica registrada na ficha do contato, mas não viaja nessa variável.
• $contact.source_channel_id — canal que criou o contato
• $contact.created_at

Configuração (filtros)

• Origem: o seletor mostra manual, API, importação em massa, mensagem recebida do WhatsApp, widget de webchat, fusão de contatos — mas como $contact.source só pode valer user/system/api/customer_reply, escolher qualquer uma dessas outras opções faz o filtro nunca bater e o fluxo não disparar.
• Tipo de canal de origem.

Como configurar

1. Abra Workflows → crie um novo fluxo.
2. Abra a categoria "Contatos" no painel de gatilhos.
3. Arraste "Contato criado" para o canvas.
4. Se for usar o filtro de Origem, escolha só entre user, system, api ou customer_reply (os outros valores do seletor não batem com nada hoje).
5. Conecte ações: adicionar etiqueta, enviar mensagem de boas-vindas, criar tarefa.
6. Salve e ative o fluxo.

Exemplo

Alguém escreve pela primeira vez no seu WhatsApp. O contato é criado automaticamente (na prática $contact.source chega como system, não como whatsapp_incoming) e o fluxo adiciona a etiqueta "Lead novo" e responde com um modelo de boas-vindas usando $contact.first_name, sem filtrar por Origem.

Dicas

Não use o filtro de Origem para distinguir "WhatsApp" de "importação em massa" — hoje não funciona assim. Se precisar separar esses casos, filtre por outro sinal disponível (por exemplo, o canal de origem) ou espere essa variável ser corrigida.

Solução de problemas

• Se o fluxo nunca disparar com um filtro de Origem diferente de user/system/api/customer_reply: é um problema conhecido, esses valores nunca são produzidos hoje.
• Se o fluxo não rodar ao importar contatos em lote, tente remover o filtro de Origem — o valor "import" nunca chega a ser gerado.