Formato de números WhatsApp no HubSpot e Flowella

Se está a utilizar o HubSpot para armazenar números WhatsApp para fluxos de trabalho Flowella, uma formatação consistente é essencial. Números no formato errado causam falhas de envio, e o mistério do “porque é que falta um dígito a este número” é 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 de importar.

Utilize o formato E.164

Armazene todos os números de telefone WhatsApp no formato E.164:

Um sinal de mais +
Indicativo do país (sem zero à esquerda)
Número nacional completo (sem o 0 de tronco inicial)

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 interface, mas as integrações — incluindo o Flowella — funcionam melhor com valores E.164 simples.

Que propriedade do HubSpot contém o número WhatsApp?

A Flowella escreve os contactos descobertos pelo WhatsApp numa propriedade dedicada — hs_whatsapp_phone_number — em vez do campo genérico phone.

Cenário	Onde a Flowella escreve / lê
Mensagem recebida de um contacto que ainda não existe no HubSpot	É criado um novo contacto HubSpot com o número WhatsApp escrito em `hs_whatsapp_phone_number`. A propriedade genérica `phone` fica em branco.
Mensagem recebida de um contacto que já existe	A Flowella procura primeiro em `hs_whatsapp_phone_number` e, em seguida, recorre a `phone` / `mobilephone` para contactos antigos.
Saída a partir de um fluxo de trabalho HubSpot	Selecione `hs_whatsapp_phone_number` no menu pendente Número de telefone do destinatário de qualquer ação de fluxo de trabalho Flowella. Recorrer a `phone` funciona, mas não é recomendado para novas automações.

Se tiver contactos existentes cujo número WhatsApp esteja em phone ou mobilephone, copie-o para hs_whatsapp_phone_number com um fluxo de trabalho ou importação do HubSpot. A pesquisa da Flowella recorre aos campos antigos, mas a correspondência de entrada é mais rápida e fiável quando o número WhatsApp está na propriedade dedicada.

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

Quando clica num campo de telefone num registo de contacto (por exemplo, Número de telemóvel), o HubSpot mostra um estado por baixo do campo. Pretende que mostre Validado. Se não mostrar Validado:

Verifique se o número começa com + e o indicativo de país correto
Verifique se não há um 0 à esquerda 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 colou um valor confuso e, em seguida, volte a guardar

Um erro comum nos fluxos de trabalho Flowella é apontar a ação para a propriedade Número de telefone em vez de Número de telemóvel. Verifique novamente qual a propriedade que contém efetivamente o número com WhatsApp ativado.

Dicas para importação de CSV e Excel

O Excel “ajuda” removendo o sinal + ou convertendo números longos em notação científica. Evite isto antes de importar:

Formate a coluna do telefone como Texto (Base → Formato de número → Texto), depois cole os valores
Ou prefixe os valores com uma plica no Excel: '+447700900123 — a plica força o tratamento como texto e não aparece nos dados importados
Em ficheiros CSV, envolva os valores entre aspas: "+447700900123"

Não importe números com espaços ou parêntesis. O HubSpot consegue muitas vezes normalizar a formatação, mas 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 limpa-os para o formato E.164, prontos para importação no HubSpot. Trata de todos os formatos de entrada comuns, incluindo:

Números locais com 0 à esquerda (por exemplo, 07700 900123)
Números com + e indicativo do país (por exemplo, +44 7700 900123)
Prefixo internacional de marcação 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 sem + (por exemplo, 447700900123)

Esta fórmula requer Excel 365 ou Google Sheets. Utiliza LET, TEXTJOIN e SEQUENCE, que não estão disponíveis em versões mais antigas do Excel.

Como utilizar a fórmula

Copie a fórmula abaixo
Cole-a em qualquer célula da sua folha de cálculo
Altere A2 para apontar para a sua primeira célula com número de telefone
Altere "44" para o seu indicativo de país (veja a tabela de referência abaixo)
Altere 10 para o comprimento esperado do número de telemóvel no seu país
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ável	O que alterar
`cell`	A célula que contém o número de telefone em bruto — altere para corresponder à sua coluna (por exemplo, `G2`)
`country_code`	O indicativo de país predefinido para números domésticos (por exemplo, `"44"` para o Reino Unido, `"1"` para os EUA)
`nsn_len`	O comprimento esperado do número de assinante nacional para números de telemóvel no seu país (por exemplo, `10` para Reino Unido e EUA)

Como funciona a fórmula

A fórmula segue quatro caminhos diferentes consoante o que encontra na entrada:

Tem + no original — já é internacional; reduz a dígitos e antepõe +
Começa com 00 — prefixo internacional de marcação; remove o 00 e antepõe +
Começa com o indicativo do país E o número de dígitos corresponde — internacional sem + (por exemplo, 447700900123); antepõe +
Tudo o resto — número doméstico; remove o 0 inicial e antepõe + mais o indicativo do país

Antes de qualquer um destes passos, a fórmula remove (0) da entrada em bruto, pelo que +44(0)7700 900123 é tratado de forma limpa.

Saída para números inválidos

Os números que não passam na validação devolvem uma mensagem clara para que possa filtrá-los e corrigi-los:

Saída	Significado
`REVIEW (not a number): hello world`	Não foram encontrados quaisquer dígitos
`REVIEW (number too short): 07700`	Dígitos insuficientes para um número válido
`REVIEW (number too long): 077009001234`	Dígitos a mais, possivelmente um prefixo duplo

A validação de comprimento aplica-se apenas a números domésticos (os que não têm + ou 00). Os números que já têm um prefixo internacional são passados tal como estão, uma vez que a fórmula não consegue saber o comprimento NSN de cada país.

Referência de indicativos de país

País	Indicativo	Comprimento NSN (telemóvel)	Notas
Reino Unido	44	10
Estados Unidos / Canadá	1	10	Todos os países NANP partilham cc=1
França	33	9
Alemanha	49	11	Apenas telemóvel; fixos variam
Espanha	34	9
Itália	39	10	Telemóveis mantêm o 3 inicial
Portugal	351	9
Países Baixos	31	9
Irlanda	353	9
Grécia	30	10
Polónia	48	9
Suíça	41	9
Turquia	90	10
Índia	91	10
Austrália	61	9
Japão	81	10
China	86	11
EAU	971	9
Arábia Saudita	966	9
África do Sul	27	9
Brasil	55	11	Telemóvel com 9.º dígito
Singapura	65	8
Hong Kong	852	8

Os valores de comprimento NSN acima referem-se a números de telemóvel. Para utilização no WhatsApp, os comprimentos exclusivos de telemóvel são os corretos. Se está a processar uma mistura de números de telemóvel e fixos, tenha em conta que alguns países (especialmente a Alemanha) têm fixos de comprimento variável.

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

Se as suas ações de fluxo de trabalho Flowella estiverem a falhar na entrega de mensagens, percorra esta lista de verificação:

Confirme que a propriedade HubSpot contém um valor no formato E.164 (começa por +)
Confirme que o campo mostra o estado Validado no HubSpot
Certifique-se de que o número inclui o indicativo do país e não tem 0 à esquerda depois dele
Garanta que a sua ação de fluxo de trabalho aponta para a propriedade correta — aquela que contém efetivamente o número com WhatsApp ativado, e não um campo de telefone diferente

Relacionado

Configuração do HubSpot

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

Ações de fluxo de trabalho

Escolha a propriedade de telefone correta ao configurar Enviar Modelo WhatsApp.

Falhas de sincronização do HubSpot

Problemas de formato de telefone são a causa mais comum de falhas de envio.

Mensagens não entregues

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

Primeiros passos

Registro de alterações

Essenciais

Usar a aplicação

Definições

Configuração Meta e WhatsApp

Integração HubSpot

Flows e campanhas

Conta e início de sessão

Segurança e privacidade

Referência da API

Resolução de problemas

Formato de números WhatsApp no HubSpot e Flowella

Utilize o formato E.164

Que propriedade do HubSpot contém o número WhatsApp?

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

Dicas para importação de CSV e Excel

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

Como utilizar a fórmula

A fórmula

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

Como funciona a fórmula

Saída para números inválidos

Referência de indicativos de país

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

Relacionado

Configuração do HubSpot

Ações de fluxo de trabalho

Falhas de sincronização do HubSpot

Mensagens não entregues

​Utilize o formato E.164

​Que propriedade do HubSpot contém o número WhatsApp?

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

​Dicas para importação de CSV e Excel

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

​Como utilizar a fórmula

​A fórmula

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

​Como funciona a fórmula

​Saída para números inválidos

​Referência de indicativos de país

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

​Relacionado

Configuração do HubSpot

Ações de fluxo de trabalho

Falhas de sincronização do HubSpot

Mensagens não entregues

Utilize o formato E.164

Que propriedade do HubSpot contém o número WhatsApp?

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

Dicas para importação de CSV e Excel

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

Como utilizar a fórmula

A fórmula

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

Como funciona a fórmula

Saída para números inválidos

Referência de indicativos de país

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

Relacionado