Formattare i numeri di telefono WhatsApp per HubSpot e Flowella

Se memorizzate i numeri WhatsApp in HubSpot per i workflow di Flowella, una formattazione coerente evita invii non riusciti. Questa pagina spiega quale formato usare, quali formati accetta Flowella, quale proprietà HubSpot legge Flowella e come ripulire un foglio di calcolo di numeri prima di importarlo.

Usare il formato E.164

Memorizzate tutti i numeri di telefono WhatsApp in formato E.164, lo standard internazionale per i numeri di telefono:

Un segno più +
Il prefisso internazionale (senza zero iniziale)
Il numero nazionale completo (senza lo 0 iniziale del prefisso di linea)

Esempi:

Numero fisso nel Regno Unito: +442079460958
Cellulare nel Regno Unito: +447700900123

Evitate spazi, parentesi e trattini. HubSpot mostra una formattazione gradevole nell’interfaccia, ma i valori E.164 puliti sono i più affidabili per le integrazioni, incluso Flowella.

Formati accettati da Flowella

Quando un’azione del workflow invia un messaggio, Flowella converte il numero memorizzato in E.164. Ignora spazi, trattini e parentesi, ma ha bisogno del prefisso internazionale.

Valore memorizzato	Cosa fa Flowella
`+44 7700 900123`	Invia a `+447700900123`
`+447700900123`	Invia a `+447700900123`
`0044 7700 900123`	Interpreta `00` come prefisso internazionale e invia a `+447700900123`
`447700900123`	Interpreta il numero come se iniziasse con un prefisso internazionale e invia a `+447700900123`
`07700 900123`	Fallisce con `CONTACT_PHONE_INVALID`, perché manca il prefisso internazionale

Flowella interpreta un numero senza + o 00 come se iniziasse con un prefisso internazionale. Un numero nazionale può quindi corrispondere al paese sbagliato. Ad esempio, il numero statunitense (202) 555-0123 memorizzato senza +1 viene letto come un numero egiziano che inizia con +20. Includete sempre il prefisso internazionale.

Quale proprietà HubSpot contiene il numero WhatsApp?

HubSpot ha una proprietà dedicata al numero di telefono WhatsApp, hs_whatsapp_phone_number. Flowella la usa per prima, prima delle proprietà generiche Mobile phone number (mobilephone) e Phone number (phone).

Scenario	Cosa legge o scrive Flowella
Messaggio in entrata da qualcuno che non è ancora in HubSpot	Flowella crea un contatto HubSpot con il numero WhatsApp in `hs_whatsapp_phone_number`. La proprietà generica `phone` resta vuota. Richiede la funzionalità CRM contacts (auto-create on new WhatsApp chat).
Messaggio in entrata da un contatto già esistente	Flowella cerca prima in `hs_whatsapp_phone_number`, poi in `mobilephone`, poi in `phone`. Quando trova un contatto corrispondente, scrive il numero WhatsApp in `hs_whatsapp_phone_number` se quella proprietà è vuota o contiene un numero diverso.
Send WhatsApp Template o Send WhatsApp Message in un workflow HubSpot	Flowella usa la proprietà telefonica che mappate nell’azione. Se quella proprietà è vuota sul contatto, prova `hs_whatsapp_phone_number`, poi `mobilephone`, poi `phone`.
Send WhatsApp Reply in un workflow HubSpot	L’azione non ha un campo telefono. Flowella prova sempre `hs_whatsapp_phone_number`, poi `mobilephone`, poi `phone`.

Se nessuna di queste proprietà contiene un numero, l’azione fallisce con CONTACT_PHONE_MISSING. Se il numero non può essere interpretato, fallisce con CONTACT_PHONE_INVALID. Vedere Codici di errore.

Mappate hs_whatsapp_phone_number nelle azioni dei vostri workflow. Se i vostri contatti esistenti hanno il numero WhatsApp in phone o mobilephone, copiatelo in hs_whatsapp_phone_number con un workflow HubSpot o un’importazione. Flowella ripiega sulle altre proprietà, ma la proprietà dedicata rende chiaro quale numero viene usato per WhatsApp.

Verificare che un numero sia valido in HubSpot

Quando fate clic su un campo telefono in una scheda contatto (ad esempio, Mobile phone number), HubSpot mostra uno stato sotto il campo. Deve indicare Validated. Se non indica Validated:

Verificate che il numero inizi con + e con il prefisso internazionale corretto
Verificate che non ci sia uno 0 iniziale dopo il prefisso internazionale (ad esempio, +4407… è sbagliato; usate +447…)
Usate l’opzione Remove number formatting di HubSpot se avete incollato un valore disordinato, poi salvate di nuovo

Verificate quale proprietà contiene effettivamente il numero abilitato a WhatsApp prima di mapparla in un’azione del workflow. Il Phone number di un contatto è spesso un numero fisso, mentre il suo numero WhatsApp potrebbe trovarsi in Mobile phone number o in hs_whatsapp_phone_number.

Suggerimenti per l’importazione da CSV ed Excel

Excel “vi aiuta” rimuovendo il segno + o convertendo i numeri lunghi in notazione scientifica. Evitatelo prima di importare:

Formattate la colonna dei telefoni come Text (Home → Number format → Text), poi incollate i valori
Oppure anteponete un apostrofo ai valori in Excel: '+447700900123. L’apostrofo forza il trattamento come testo e non comparirà nei dati importati
Nei file CSV, racchiudete i valori tra virgolette: "+447700900123"

Non importate numeri con spazi o parentesi. HubSpot riesce spesso a normalizzare la formattazione, ma i valori E.164 puliti danno i risultati più coerenti.

Formula Excel: ripulire i numeri di telefono in E.164

Se avete un foglio di calcolo pieno di numeri di telefono in formati diversi, la formula seguente li ripulisce nel formato E.164, pronti per l’importazione in HubSpot. Gestisce tutti i formati di input comuni, tra cui:

Numeri locali con uno 0 iniziale (ad es. 07700 900123)
Numeri con + e prefisso internazionale (ad es. +44 7700 900123)
Prefisso di chiamata internazionale 00 (ad es. 0044 7700 900123)
Il formato +44(0)7...
Trattini, punti, parentesi e altra punteggiatura
Numeri che hanno già il prefisso internazionale ma senza + (ad es. 447700900123)

Questa formula richiede Excel 365 o Google Sheets. Usa LET, TEXTJOIN e SEQUENCE, che non sono disponibili nelle versioni precedenti di Excel.

Come usare la formula

Copiate la formula qui sotto
Incollatela in una cella qualsiasi del foglio di calcolo
Cambiate A2 in modo che punti alla prima cella con un numero di telefono
Cambiate "44" con il vostro prefisso internazionale (vedere la tabella di riferimento qui sotto)
Cambiate 10 con la lunghezza prevista dei numeri di cellulare nel vostro paese
Premete Invio, poi trascinate verso il basso per applicarla a tutte le righe

La formula

=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))))
)

Cosa significano le tre variabili di configurazione

Variabile	Cosa cambiare
`cell`	La cella che contiene il numero di telefono grezzo. Cambiatela in base alla vostra colonna (ad es. `G2`)
`country_code`	Il prefisso internazionale predefinito per i numeri nazionali (ad es. `"44"` per il Regno Unito, `"1"` per gli Stati Uniti)
`nsn_len`	La lunghezza prevista del numero nazionale dell’abbonato per i cellulari nel vostro paese (ad es. `10` per Regno Unito e Stati Uniti)

Come funziona la formula

La formula segue quattro percorsi diversi a seconda di ciò che trova nell’input:

Contiene + nell’originale: è già internazionale. Riduce alle sole cifre e antepone +
Inizia con 00: prefisso di chiamata internazionale. Rimuove 00 e antepone +
Inizia con il prefisso internazionale E il numero di cifre corrisponde: internazionale senza segno (ad es. 447700900123). Antepone +
Tutto il resto: numero nazionale. Rimuove lo 0 iniziale e antepone + più il prefisso internazionale

Prima di tutto questo, la formula rimuove (0) dall’input grezzo, quindi +44(0)7700 900123 viene gestito correttamente.

Output per numeri non validi

I numeri che non superano la validazione restituiscono un messaggio chiaro, così potete filtrarli e correggerli:

Output	Significato
`REVIEW (not a number): hello world`	Nessuna cifra trovata
`REVIEW (number too short): 07700`	Cifre insufficienti per un numero valido
`REVIEW (number too long): 077009001234`	Troppe cifre, forse un doppio prefisso

La validazione della lunghezza si applica solo ai numeri nazionali (quelli senza + o 00). I numeri che hanno già un prefisso internazionale vengono lasciati invariati, poiché la formula non può conoscere la lunghezza del NSN per ogni paese.

Riferimento dei prefissi internazionali

Paese	Prefisso internazionale	Lunghezza NSN (cellulare)	Note
Regno Unito	44	10
Stati Uniti / Canada	1	10	Tutti i paesi NANP condividono cc=1
Francia	33	9
Germania	49	11	Solo cellulari; i numeri fissi variano
Spagna	34	9
Italia	39	10	I cellulari mantengono il 3 iniziale
Portogallo	351	9
Paesi Bassi	31	9
Irlanda	353	9
Grecia	30	10
Polonia	48	9
Svizzera	41	9
Turchia	90	10
India	91	10
Australia	61	9
Giappone	81	10
Cina	86	11
Emirati Arabi Uniti	971	9
Arabia Saudita	966	9
Sudafrica	27	9
Brasile	55	11	Cellulari con la nona cifra
Singapore	65	8
Hong Kong	852	8

I valori di lunghezza NSN qui sopra si riferiscono ai numeri di cellulare. Per l’uso con WhatsApp, le lunghezze dei soli cellulari sono corrette. Se elaborate un mix di numeri di cellulare e fissi, tenete presente che alcuni paesi (in particolare la Germania) hanno numeri fissi di lunghezza variabile.

Checklist rapida per la risoluzione dei problemi

Se le azioni dei workflow Flowella falliscono con CONTACT_PHONE_MISSING o CONTACT_PHONE_INVALID, seguite questa checklist:

Verificate che la proprietà HubSpot contenga un valore in formato E.164 (che inizia con +)
Verificate che il campo mostri lo stato Validated in HubSpot
Assicuratevi che il numero includa il prefisso internazionale e che non ci sia uno 0 iniziale subito dopo
Assicuratevi che l’azione del workflow punti alla proprietà che contiene effettivamente il numero abilitato a WhatsApp, idealmente hs_whatsapp_phone_number
Se la proprietà mappata è vuota, controllate le proprietà di riserva nell’ordine in cui Flowella le legge: hs_whatsapp_phone_number, mobilephone, phone

Correlati

Collegare HubSpot

Collegate il vostro account HubSpot e verificate le vostre funzionalità.

Azioni dei workflow

Scegliete la proprietà telefonica giusta quando configurate Send WhatsApp Template.

Errori di sincronizzazione HubSpot

I problemi di formato del telefono sono la causa più comune degli invii non riusciti.

Messaggi non consegnati

Diagnosticate i singoli invii che non raggiungono il destinatario.

Per iniziare

Essenziali

Usare l'app

Impostazioni

Configurazione Meta e WhatsApp

Integrazione HubSpot

Flow e campagne

Riferimento API

Risoluzione problemi

Registro modifiche

Formattare i numeri di telefono WhatsApp per HubSpot e Flowella

Usare il formato E.164

Formati accettati da Flowella

Quale proprietà HubSpot contiene il numero WhatsApp?

Verificare che un numero sia valido in HubSpot

Suggerimenti per l’importazione da CSV ed Excel

Formula Excel: ripulire i numeri di telefono in E.164

Come usare la formula

La formula

Cosa significano le tre variabili di configurazione

Come funziona la formula

Output per numeri non validi

Riferimento dei prefissi internazionali

Checklist rapida per la risoluzione dei problemi

Correlati

Collegare HubSpot

Azioni dei workflow

Errori di sincronizzazione HubSpot

Messaggi non consegnati

​Usare il formato E.164

​Formati accettati da Flowella

​Quale proprietà HubSpot contiene il numero WhatsApp?

​Verificare che un numero sia valido in HubSpot

​Suggerimenti per l’importazione da CSV ed Excel

​Formula Excel: ripulire i numeri di telefono in E.164

​Come usare la formula

​La formula

​Cosa significano le tre variabili di configurazione

​Come funziona la formula

​Output per numeri non validi

​Riferimento dei prefissi internazionali

​Checklist rapida per la risoluzione dei problemi

​Correlati

Collegare HubSpot

Azioni dei workflow

Errori di sincronizzazione HubSpot

Messaggi non consegnati

Usare il formato E.164

Formati accettati da Flowella

Quale proprietà HubSpot contiene il numero WhatsApp?

Verificare che un numero sia valido in HubSpot

Suggerimenti per l’importazione da CSV ed Excel

Formula Excel: ripulire i numeri di telefono in E.164

Come usare la formula

La formula

Cosa significano le tre variabili di configurazione

Come funziona la formula

Output per numeri non validi

Riferimento dei prefissi internazionali

Checklist rapida per la risoluzione dei problemi

Correlati