Correspondência de Contactos
A correspondência de contactos reconhece automaticamente que dois registos recebidos pertencem à mesma pessoa real — mesmo quando chegam por canais diferentes (número de WhatsApp, endereço de e-mail, ID de Instagram). Objetivo: um único registo de cliente por pessoa, sem duplicados.
O que é a correspondência de contactos?
A correspondência de contactos (frequentemente «resolução de identidade» ou «deteção de duplicados») é a lógica que permite a uma plataforma decidir: «Esta mensagem recebida de WhatsApp vinda do +351 912 345 678 pertence à mesma pessoa cujo e-mail [email protected] já conhecemos.» O resultado é um único registo de cliente, não um cemitério de meios-perfis.
Porque a correspondência é essencial
Sem correspondência chega-se rapidamente a isto:
- A Anna está na lista de e-mail como [email protected]
- A Anna é um contacto WhatsApp em +351 912 …
- A Anna inscreveu-se via formulário de newsletter como «Anna K.»
- Três registos, uma única pessoa real — sem correspondência, os três são abordados em separado.
As consequências: mensagens de marketing duplicadas, lifetime value mal calculado, histórico de apoio fragmentado, problemas RGPD nos pedidos de titulares de dados.
Sinais de correspondência
As plataformas usam tipicamente estes identificadores:
| Sinal | Força | Nota |
|---|---|---|
| Número de telefone (formato E.164) | Muito forte | Único se formatado de modo uniforme. |
| Endereço de e-mail | Muito forte | Único, mas há erros de digitação. |
| ID de plataforma (WhatsApp ID, Telegram ID, handle de Instagram) | Muito forte | Emitido pelo fornecedor, imutável. |
| Nome | Fraco | Muitas Annas no sistema — só útil em combinação. |
Três modos comparados
| Modo | O que acontece em colisão | Quando usar |
|---|---|---|
| Fusão automática (predefinição) | Atualiza-se o contacto existente em vez de criar um novo. O contacto mais antigo mantém-se como principal; os campos em falta são preenchidos. | Por defeito para a maioria das PME. Entrega um registo de cliente limpo sem trabalho manual. |
| Permitir duplicados | São criados ambos os contactos. A plataforma informa na resposta que podem existir duplicados (lista de sugestões). | Raro — p. ex. configurações de marketplace em que cada inscrição é uma conta própria. |
| Bloquear duplicados | A plataforma rejeita a criação (HTTP 409) e devolve o contacto existente. | Quando quer unicidade rigorosa — p. ex. em B2B sales. |
Regras de fusão (o que acontece numa fusão)
- O contacto mais antigo continua a ser o principal. Ambos os IDs continuam a resolver para o registo sobrevivente.
- Os valores não vazios vencem. Em conflito, decide a data de criação mais antiga.
- Campos pegajosos:
is_blockedeis_archivedpermanecem «true» se algum dos registos os tivesse — uma fusão nunca deve desbloquear silenciosamente um contacto. - O histórico migra: Conversas, mensagens, notas, etiquetas, campos personalizados e métodos de contacto vão todos para o sobrevivente.
- Nota do sistema no registo de auditoria: O que foi fundido, o que entrou em conflito — totalmente documentado.
O que acontece aos IDs antigos
As integrações externas, webhooks, CRMs referenciam muitas vezes IDs de contacto antigos. Após uma fusão, esses IDs antigos não devem retornar 404. Solução: a API resolve transparentemente o ID antigo para o sobrevivente, devolve adicionalmente um campo merged_from e define um cabeçalho X-Merged-Into. As integrações existentes não partem.
Caso limite de canal: primeiro contacto num novo canal
Exceção importante: quando chega uma mensagem WhatsApp para um número de telefone que já conhecemos — mas o contacto ainda não tem ID de WhatsApp —, isto não é um duplicado. É um novo método de contacto no contacto existente. A fusão automática aplica-se independentemente do modo.
Fusão manual
Nem todos os duplicados são detetados automaticamente. Nomes foneticamente semelhantes, nome/apelido trocados, contas deliberadamente separadas — esses precisam de fusão manual. Uma vista «Encontrar duplicados» mostra candidatos agrupados por sinal de correspondência, com opção de fusão em massa.
Correspondência de contactos na SendSeven
A SendSeven suporta todos os três modos (Fusão automática por defeito, Permitir, Bloquear), uma override por pedido via o campo duplicate_mode, fusão manual na UI e pela REST API (POST /contacts/{id}/merge). Os sinais de correspondência são telefone, e-mail, ID de plataforma e nome (como sinal fraco na lista de sugestões). Todas as fusões são registadas no log de auditoria; os UUIDs antigos continuam resolúveis.