> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Formato de números WhatsApp no HubSpot e Flowella > Guarde números WhatsApp em formato E.164 no HubSpot, importe sem falhas a partir de CSV e Excel e use a fórmula para converter automaticamente números confusos. 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 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 sua primeira célula com número de telefone 4. Altere `"44"` para o seu indicativo de país (veja 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 ```excel theme={null} =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 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: 1. **Tem `+` no original** — já é internacional; reduz a dígitos e antepõe `+` 2. **Começa com `00`** — prefixo internacional de marcação; remove o `00` e antepõe `+` 3. **Começa com o indicativo do país E o número de dígitos corresponde** — internacional sem `+` (por exemplo, `447700900123`); antepõe `+` 4. **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 Ligue o seu portal HubSpot e escolha que propriedades a Flowella lê. Escolha a propriedade de telefone correta ao configurar Enviar Modelo WhatsApp. Problemas de formato de telefone são a causa mais comum de falhas de envio. Diagnostique envios individuais que não chegam ao destinatário. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.