Contato: Criar

Quando usar

• Um novo lead chega via formulario ou webhook e voce precisa cadastra-lo


• Quer criar contatos automaticamente a partir de dados recebidos de um sistema externo


• Precisa registrar um contato capturado via chatbot ou canal omni


• Quer garantir que contatos nao sejam duplicados (upsert pelo canal principal)

---

Como funciona

O node cria um novo contato no workspace com os dados configurados. Se ja existir um contato com o mesmo canal principal (mesmo e-mail ou telefone marcado como principal), o contato existente e atualizado em vez de duplicado. Apos a execucao, retorna os dados do contato criado/atualizado, incluindo indicadores de se foi criacao ou atualizacao.

> Importante: Este componente e compartilhado com os nodes "Contato: Atualizar" e "Contato: Deletar". A diferenca esta no tipo de operacao (create vs. update vs. delete).

---

Configuracoes

Nome *

Campo obrigatorio. Nome completo do contato. Aceita variaveis dinamicas.

Exemplo: `{{trigger.output.body.nome}}` ou `Joao da Silva`

Empresa

Campo opcional. Nome da empresa do contato. Aceita variaveis dinamicas.

Exemplo: `{{trigger.output.body.empresa}}` ou `Empresa LTDA`

Canais de Contato

Lista de canais de comunicacao do contato. Clique em + Adicionar para incluir um novo canal. Cada canal tem:

| Campo | Descricao |
|-------|-----------|
| Tipo | Tipo do canal: E-mail, Telefone, WhatsApp, Telegram ou Instagram |
| Valor | O endereco/numero do canal. Ex: `[email protected]`, `+5548999999999`, `@usuario` |
| Principal | Checkbox que marca este canal como o principal (usado para deduplicacao) |
| Rotulo | Rotulo descritivo opcional. Ex: `Trabalho`, `Pessoal` |

O primeiro canal adicionado e marcado automaticamente como principal.

Tags

Lista de tags para categorizar o contato. Clique em + Adicionar para incluir uma nova tag.

Exemplo: `cliente-vip`, `lead-quente`, `{{trigger.output.body.segmento}}`

Origem (opcional)

Dois campos opcionais para rastrear de onde o contato veio:

| Campo | Descricao |
|-------|-----------|
| Canal | Canal de origem. Ex: `whatsapp`, `form`, `webhook` |
| Referencia | Referencia da campanha ou fonte. Ex: `campaign_123`, `landing-page-natal` |

---

Dados de saida

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `contact.id` | Texto | ID unico do contato criado |
| `contact.name` | Texto | Nome do contato |
| `contact.email` | Texto | E-mail principal do contato |
| `contact.phone` | Texto | Telefone principal do contato |
| `contact.company` | Texto | Empresa do contato |
| `contact.tags` | Lista | Tags associadas ao contato |

Adicionalmente, o outputSchema dinamico do componente inclui:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | ID do contato |
| `name` | Texto | Nome do contato |
| `company` | Texto | Empresa |
| `created` | Booleano | `true` se o contato foi criado (novo) |
| `updated` | Booleano | `true` se o contato ja existia e foi atualizado |

---

Dicas

• Sempre defina pelo menos um canal principal — ele e usado para detectar duplicatas. Se voce criar um contato com o e-mail `[email protected]` como principal, e ja existir um contato com esse mesmo e-mail principal, o contato existente sera atualizado.


• Use os campos `created` e `updated` da saida para condicionar acoes seguintes. Por exemplo, envie um e-mail de boas-vindas apenas quando `created` for `true`.


• Combine com o gatilho Webhook para criar contatos automaticamente quando um formulario externo envia dados.


• Use tags para segmentar contatos e facilitar buscas e filtros futuros.