Passar para o conteúdo principal

📞 Configuração do Telefone como Identificador no HubSpot

Configure o número de telefone como identificador principal entre Atom e HubSpot. Aprenda a formatar, mapear e flexibilizar validações para garantir a criação fluida de contatos e manter seu banco de dados impecável. 🚀

Seleção do Identificador Principal

O identificador telefônico selecionado (Número de telefone, Telefone móvel ou Número de telefone do WhatsApp) define o destino padrão onde Atom inserirá ou atualizará o número do cliente. Esta atribuição só pode ser configurada uma vez.

Siga estes passos para escolher a melhor opção:

  1. Acesse o assistente de configuração One Click Integration no Atom.

  2. Revise a quantidade de registros (Contatos) que a interface exibe junto a cada opção disponível.

  3. Selecione o campo que possua o maior volume de registros para reduzir a fricção de sincronização inicial.

💡 Dica: Embora defina um campo principal, o mecanismo de resolução do Atom executará buscas simultâneas nos três campos telefônicos do HubSpot para garantir o emparelhamento exato e evitar duplicatas.


Formato E.164 e Captura de Dados

Para garantir uma leitura ideal entre sistemas e prevenir a criação de perfis duplicados, a melhor prática é estruturar os números sob o padrão internacional Formato E.164.

  • Auditoria de origem: Verifique que todos os seus formulários de captura de leads (próprios ou integrados ao HubSpot) exijam obrigatoriamente a inclusão do código do país.

  • Resolução de variações: Atom utiliza uma lógica avançada capaz de processar variações e códigos regionais complexos (como os do Brasil, Argentina ou México). Isso permite vincular corretamente a conversa ao contato no HubSpot, mesmo se o usuário escrever seu número com pequenas diferenças no chat.

Estrutura de número E.164

+99 9 9999 9999

│ │ └───┬───┘

│ │ │

│ │ └──── Número de Assinante (Linha local do usuário)

│ │

│ └────────── Código de Área / Operador (Região ou rede específica)

│

└────────────── Símbolo "+" e Código do País (Ex. "99" - País fictício)


Flexibilidade nas Validações do HubSpot

Ao enviar informações de um novo cliente, Atom transmite o telefone em seus Payloads (pacotes de dados) como um valor puramente numérico, sem incluir o símbolo +. Uma regra de validação muito rigorosa bloqueará a integração.

  1. Acesse a configuração global de Propriedades dentro do HubSpot.

  2. Revise as regras de validação atribuídas às suas propriedades telefônicas.

  3. Certifique-se de que a opção permita a inserção de números com código de país sem exigir explicitamente o uso do sinal + no início.

⚠️ Importante: Se configurar o telefone como um campo que exige obrigatoriamente o símbolo + por padrão no HubSpot, Atom não conseguirá criar contatos novos de forma autônoma, o que resultará em perda de rastreabilidade dos dados coletados.


Erros Comuns que Você Deve Evitar

Para garantir uma implantação bem-sucedida, evite estas configurações que podem comprometer o fluxo de suas informações:

Erro Frequente

Impacto Operativo

Ação Recomendada

Tentar alterar o identificador após salvar

A atribuição é bloqueada. Modificá-la no futuro exige eliminar a integração e refazer todo o processo do zero, provocando a perda irreversível de seus mapeamentos anteriores.

Defina em equipe qual será o campo telefônico definitivo antes de salvar a configuração inicial do One Click Integration.

Manter regras de validação rigorosas no HubSpot

Atom falhará ao tentar criar perfis autonomamente, e você perderá as informações coletadas por meio de tipificações ou tarefas automáticas.

Ajuste as regras no HubSpot para aceitar valores numéricos internacionais que provenham diretamente da plataforma sem o caractere +.


Estabelecer regras claras para o formato e a validação de seus números telefônicos elimina fricções operativas desde o primeiro dia. Ao configurar corretamente seu identificador, você garante que cada lead capturado por Atom viaje de forma limpa para o HubSpot, mantendo seu ecossistema 100% sincronizado e pronto para potencializar suas vendas. ✅

Respondeu à sua pergunta?