Saltar para o conteúdo principal
Se estiver a utilizar o HubSpot para armazenar números WhatsApp para fluxos de trabalho Flowella, a formatação consistente é essencial. Números no formato errado causam falhas nos envios e o mistério “porque é que este número não tem um dígito” é quase sempre um problema de formatação. Esta página explica o formato correto, como verificá-lo no HubSpot, como importar de forma limpa e como corrigir uma folha de cálculo cheia de números confusos antes da importação.

​
Utilizar o formato E.164

Armazene todos os números de telefone do WhatsApp no formato E.164:
  • Um sinal de mais +
  • Código do país (sem zero à esquerda)
  • Número nacional completo (sem o tronco inicial 0)
**Exemplos
  • Telefone fixo do Reino Unido: +442079460958
  • Telemóvel do Reino Unido: +447700900123
Evite espaços, parêntesis e hífenes. O HubSpot apresenta uma boa formatação na IU, mas as integrações - incluindo o Flowella - funcionam melhor com valores E.164 simples.

​
Verificar se um número é válido no HubSpot

Quando se clica num campo de telefone num registo de contacto (por exemplo, Número de telemóvel), o HubSpot mostra um estado sob a entrada. Pretende que este mostre Validado. Se não mostrar Validado:
  • Verifique se o número começa com + e o código de país correto
  • Verifique se não existe nenhum 0 inicial após o indicativo do país (por exemplo, +4407… está errado - deveria ser +447…)
  • Utilize a opção Remover formatação do número do HubSpot se tiver colado um valor confuso e, em seguida, volte a guardar
Um erro comum nos fluxos de trabalho do Flowella é apontar a ação para a propriedade Número de telefone em vez de Número de telemóvel. Verificar duas vezes qual a propriedade que contém efetivamente o número ativado pelo WhatsApp.

​
Dicas de importação CSV e Excel

O Excel irá “ajudar” removendo o sinal + ou convertendo números longos em notação científica. Evite isso antes de importar:
  • Formate a coluna do telefone como Texto (Página inicial → Formato de número → Texto) e, em seguida, cole os valores
  • Ou prefixar os valores com um apóstrofo no Excel: '+447700900123 - o apóstrofo força o tratamento do texto e não aparecerá nos dados importados
  • Nos ficheiros CSV, coloque os valores entre aspas: "+447700900123"
Não importar números com espaços ou parêntesis. O HubSpot pode frequentemente normalizar a formatação, mas os valores E.164 limpos dão os resultados mais consistentes.

​
Fórmula Excel: limpar números de telefone para E.164

Se tiver uma folha de cálculo cheia de números de telefone em vários formatos, a fórmula abaixo irá limpá-los para o formato E.164, prontos para serem importados pelo HubSpot. Ela lida com todos os formatos de entrada comuns, incluindo:
  • Números locais com um 0 inicial (por exemplo, 07700 900123)
  • Números com + e código do país (por exemplo, +44 7700 900123)
  • Prefixo de marcação internacional 00 (por exemplo, 0044 7700 900123)
  • O formato +44(0)7...
  • Hífenes, pontos, parêntesis e outra pontuação
  • Números que já têm o indicativo do país mas não têm + (por exemplo, 447700900123)
Esta fórmula requer Excel 365 ou Google Sheets. Ela usa LET, TEXTJOIN e SEQUENCE, que não estão disponíveis em versões mais antigas do Excel.

​
Como usar a fórmula

  1. Copie a fórmula abaixo
  2. Cole-a em qualquer célula da sua folha de cálculo
  3. Altere A2 para apontar para a célula do seu primeiro número de telefone
  4. Altere "44" para o código do seu país (consulte a tabela de referência abaixo)
  5. Altere 10 para o comprimento esperado do número de telemóvel no seu país
  6. Prima Enter e, em seguida, arraste para baixo para aplicar a todas as linhas

​
A fórmula

=LET(
  cell, A2,
  country_code, "44",
  nsn_len, 10,
  raw, TRIM(cell&""),
  clean, SUBSTITUTE(raw,"(0)",""),
  digits, TEXTJOIN("",,IFERROR(MID(clean,SEQUENCE(LEN(clean)),1)*1,"")),
  has_plus, ISNUMBER(FIND("+",raw)),
  has_00, LEFT(digits,2)="00",
  p, LEN(country_code),
  starts_cc, AND(LEFT(digits,p)=country_code, LEN(digits)=p+nsn_len),
  nsn, IF(has_plus, digits,
    IF(has_00, MID(digits,3,999),
    IF(starts_cc, MID(digits,p+1,999),
    IF(LEFT(digits,1)="0", MID(digits,2,999), digits)))),
  intl, IF(has_plus, "+"&digits,
    IF(has_00, "+"&MID(digits,3,999),
    IF(starts_cc, "+"&digits,
    "+"&country_code&nsn))),
  is_domestic, AND(NOT(has_plus), NOT(has_00), NOT(starts_cc)),
  IF(raw="","",
  IF(digits="","REVIEW (not a number): "&raw,
  IF(AND(is_domestic, LEN(nsn)<nsn_len),"REVIEW (number too short): "&raw,
  IF(AND(is_domestic, LEN(nsn)>nsn_len),"REVIEW (number too long): "&raw,
  intl))))
)

​
O que significam as três variáveis de configuração

VariávelO que mudar
cellA célula que contém o número de telefone bruto - altere para corresponder à sua coluna (por exemplo, G2)
O código de país padrão para números domésticos (por exemplo, "44" para o Reino Unido, "1" para os EUA)
nsn_lenO comprimento esperado do número de assinante nacional para números móveis no seu país (por exemplo, 10 para o Reino Unido e os EUA)

​
Como a fórmula funciona

A fórmula segue quatro caminhos diferentes, dependendo do que encontra na entrada:
  1. Tem + no original - já é internacional; retira os dígitos e acrescenta +
  2. Começa com 00 - prefixo de marcação internacional; retirar o 00 e acrescentar +
  3. Começa com o indicativo do país E a contagem de dígitos coincide - internacional simples (por exemplo, 447700900123); prefixar +
  4. Tudo o resto - número nacional; retirar o 0 inicial e prefixar o + mais o indicativo do país
Antes de tudo isso, a fórmula remove (0) da entrada bruta, de modo que +44(0)7700 900123 é tratado de forma limpa.

​
Saída de número inválido

Os números que não passam na validação retornam uma mensagem clara para que você possa filtrá-los e corrigi-los:
SaídaSignificado
REVIEW (not a number): hello worldNenhum dígito encontrado
REVIEW (number too short): 07700Não há dígitos suficientes para um número válido
REVIEW (number too long): 077009001234Demasiados dígitos, possivelmente um prefixo duplo
A validação do comprimento só se aplica a números nacionais (aqueles sem + ou 00). Os números que já têm um prefixo internacional são passados como estão, uma vez que a fórmula não pode saber o comprimento do NSN para cada país.

​
Referência do código do país

PaísCódigo do paísComprimento do NSN (móvel)Notas
Reino Unido4410
Estados Unidos / Canadá110Todos os países NANP partilham cc=1
França339
Alemanha4911Apenas telemóveis; telefones fixos variam
Espanha349
Itália3910Os telemóveis mantêm a liderança 3
Portugal3519
Holanda319
Irlanda3539
Grécia3010
Polónia489
Suíça419
Turquia9010
Índia9110
Austrália619
Japão8110
China8611
EMIRADOS ÁRABES UNIDOS9719
Arábia Saudita9669
África do Sul279
Brasil5511Celular com 9º dígito
Singapura658
Hong Kong8528
Os valores de comprimento NSN acima são para números móveis. Para utilização do WhatsApp, os comprimentos apenas para telemóveis estão corretos. Se estiver a processar uma mistura de números móveis e fixos, tenha em atenção que alguns países (especialmente a Alemanha) têm números fixos de comprimento variável.

​
Lista de verificação rápida de resolução de problemas

Se as acções do fluxo de trabalho do Flowella não estiverem a conseguir entregar mensagens, consulte esta lista de verificação:
  • Confirmar que a propriedade HubSpot contém um valor no formato E.164 (começa com +)
  • Confirmar que o campo mostra o status Validado em HubSpot
  • Certifique-se de que o número inclui o código do país e não tem nenhum 0 inicial a seguir
  • Certifique-se de que a sua ação de fluxo de trabalho está a apontar para a propriedade correta - a que realmente contém o número ativado pelo WhatsApp, e não um campo de telefone diferente

​
Relacionado

Configuração do HubSpot

Ligue o seu portal HubSpot e escolha as propriedades que o Flowella lê.

Acções de fluxo de trabalho

Escolha a propriedade correta do telefone ao configurar o Modelo de Envio WhatsApp.

Falhas de sincronização do HubSpot

Os problemas de formato do telefone são a causa mais comum de envios falhados.

Mensagens não entregues

Diagnosticar envios individuais que não chegam ao destinatário.