> ## 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 dei numeri di telefono WhatsApp in HubSpot

> Memorizzate i numeri WhatsApp in formato E.164 in HubSpot, importate in modo pulito da CSV o Excel e usate la formula per convertire numeri non ordinati.

Se sta utilizzando HubSpot per memorizzare i numeri WhatsApp per i workflow Flowella, una formattazione coerente è essenziale. I numeri nel formato sbagliato causano invii falliti, e il mistero "perché manca una cifra a questo numero" è quasi sempre un problema di formattazione. Questa pagina spiega il formato corretto, come verificarlo in HubSpot, come importare in modo pulito e come correggere un foglio di calcolo pieno di numeri non ordinati prima dell'importazione.

## Utilizzi il formato E.164

Memorizzi tutti i numeri di telefono WhatsApp in **formato E.164**:

* Un segno più `+`
* Prefisso paese (senza zero iniziale)
* Numero nazionale completo (senza lo `0` di prefisso interurbano iniziale)

**Esempi:**

* Telefono fisso UK: `+442079460958`
* Cellulare UK: `+447700900123`

Eviti spazi, parentesi e trattini. HubSpot mostra la formattazione in modo gradevole nell'interfaccia, ma le integrazioni — incluso Flowella — funzionano meglio con valori E.164 semplici.

## Quale proprietà HubSpot contiene il numero WhatsApp?

Flowella scrive i contatti scoperti tramite WhatsApp in una proprietà dedicata — **`hs_whatsapp_phone_number`** — invece del campo generico `phone`.

| Scenario                                                             | Dove Flowella scrive / legge                                                                                                                                                                                |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Messaggio in entrata da un contatto che non esiste ancora in HubSpot | Viene creato un nuovo contatto HubSpot con il numero WhatsApp scritto in `hs_whatsapp_phone_number`. La proprietà generica `phone` viene lasciata vuota.                                                    |
| Messaggio in entrata da un contatto già esistente                    | Flowella cerca **prima** in `hs_whatsapp_phone_number`, quindi ricorre a `phone` / `mobilephone` per i contatti legacy.                                                                                     |
| In uscita da un workflow HubSpot                                     | Selezioni `hs_whatsapp_phone_number` nel menu a tendina **Recipient Phone Number** di qualsiasi azione di workflow Flowella. Il fallback a `phone` funziona ma non è raccomandato per le nuove automazioni. |

<Tip>
  Se ha contatti esistenti il cui numero WhatsApp si trova in `phone` o `mobilephone`, lo copi su `hs_whatsapp_phone_number` con un workflow o un'importazione HubSpot. La ricerca di Flowella ricorre ai campi legacy, ma **l'abbinamento in entrata è più rapido e affidabile quando il numero WhatsApp è sulla proprietà dedicata**.
</Tip>

## Verifichi che un numero sia valido in HubSpot

Quando fa clic in un campo telefono su un record di contatto (ad esempio, **Numero di cellulare**), HubSpot mostra uno stato sotto l'input. Vuole che mostri **Validato**.

Se non mostra Validato:

* Verifichi che il numero inizi con `+` e con il prefisso paese corretto
* Verifichi che **non ci sia uno `0` iniziale dopo il prefisso paese** (ad esempio, `+4407…` è errato — dovrebbe essere `+447…`)
* Utilizzi l'opzione **Rimuovi formattazione numero** di HubSpot se ha incollato un valore non ordinato, quindi salvi di nuovo

<Tip>
  Un errore comune nei workflow Flowella è puntare l'azione alla proprietà **Numero di telefono** invece di **Numero di cellulare**. Verifichi due volte quale proprietà contiene effettivamente il numero abilitato per WhatsApp.
</Tip>

## Consigli per l'importazione da CSV ed Excel

Excel "aiuterà" rimuovendo il segno `+` o convertendo numeri lunghi in notazione scientifica. Lo prevenga prima di importare:

* Formatti la colonna telefono come **Testo** (Home → Formato numero → Testo), *poi* incolli i valori
* Oppure anteponga ai valori un apostrofo in Excel: `'+447700900123` — l'apostrofo forza la gestione come testo e non apparirà nei dati importati
* Nei file CSV, racchiuda i valori tra virgolette: `"+447700900123"`

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

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

Se ha un foglio di calcolo pieno di numeri di telefono in vari formati, la formula qui sotto li ripulirà in formato E.164, pronti per l'importazione in HubSpot.

Gestisce tutti i formati di input comuni, inclusi:

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

<Note>
  Questa formula richiede **Excel 365 o Google Sheets**. Utilizza `LET`, `TEXTJOIN` e `SEQUENCE`, che non sono disponibili nelle versioni precedenti di Excel.
</Note>

### Come utilizzare la formula

1. Copi la formula qui sotto
2. La incolli in qualsiasi cella del Suo foglio di calcolo
3. Cambi `A2` in modo che punti alla prima cella del numero di telefono
4. Cambi `"44"` con il Suo prefisso paese (vedere la tabella di riferimento qui sotto)
5. Cambi `10` con la lunghezza prevista del numero di cellulare per il Suo paese
6. Prema Invio, quindi trascini verso il basso per applicare a tutte le righe

### La formula

```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 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 contenente il numero di telefono grezzo — la cambi in base alla Sua colonna (ad esempio, `G2`)                      |
| `country_code` | Il prefisso paese predefinito per i numeri nazionali (ad esempio, `"44"` per UK, `"1"` per US)                               |
| `nsn_len`      | La lunghezza prevista del numero subscriber nazionale per i numeri di cellulare nel Suo paese (ad esempio, `10` per UK e US) |

### Come funziona la formula

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

1. **Ha `+` nell'originale** — già internazionale; togliere fino alle cifre e anteporre `+`
2. **Inizia con `00`** — prefisso internazionale di selezione; togliere il `00` e anteporre `+`
3. **Inizia con il prefisso paese E il numero di cifre corrisponde** — internazionale nudo (ad esempio, `447700900123`); anteporre `+`
4. **Tutto il resto** — numero nazionale; togliere lo `0` iniziale e anteporre `+` più il prefisso paese

Prima di tutto questo, la formula rimuove `(0)` dall'input grezzo, in modo che `+44(0)7700 900123` sia gestito in modo pulito.

### Output di numero non valido

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

| Output                                   | Significato                               |
| ---------------------------------------- | ----------------------------------------- |
| `REVIEW (not a number): hello world`     | Nessuna cifra trovata                     |
| `REVIEW (number too short): 07700`       | Non abbastanza cifre per un numero valido |
| `REVIEW (number too long): 077009001234` | Troppe cifre, possibile doppio prefisso   |

La convalida della lunghezza si applica solo ai numeri nazionali (quelli senza `+` o `00`). I numeri che hanno già un prefisso internazionale vengono passati così come sono, poiché la formula non può conoscere la lunghezza NSN per ogni paese.

## Riferimento per i prefissi paese

| Paese                | Prefisso paese | 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 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                        | Cellulare con 9ª cifra               |
| Singapore            | 65             | 8                         |                                      |
| Hong Kong            | 852            | 8                         |                                      |

I valori di lunghezza NSN qui sopra sono per i numeri di cellulare. Per l'uso WhatsApp, le lunghezze solo per cellulare sono corrette. Se sta elaborando una combinazione di numeri di cellulare e di rete fissa, tenga presente che alcuni paesi (specialmente la Germania) hanno linee fisse a lunghezza variabile.

## Checklist rapida per la risoluzione dei problemi

<Tip>
  Se le Sue azioni di workflow Flowella non riescono a consegnare i messaggi, segua questa checklist:

  * Confermi che la proprietà HubSpot contenga un valore in **formato E.164** (inizia con `+`)
  * Confermi che il campo mostri lo stato **Validato** in HubSpot
  * Si assicuri che il numero includa il prefisso paese e che **non abbia uno `0` iniziale** dopo
  * Si assicuri che l'azione di workflow stia puntando alla proprietà corretta — quella che contiene effettivamente il numero abilitato per WhatsApp, non un altro campo telefono
</Tip>

## Correlati

<CardGroup cols={2}>
  <Card title="Configurazione HubSpot" icon="plug" href="/hubspot/setup">
    Colleghi il Suo portale HubSpot e scelga quali proprietà legge Flowella.
  </Card>

  <Card title="Azioni del workflow" icon="git-branch" href="/hubspot/workflow-actions">
    Scelga la proprietà telefono corretta quando configura Invia modello WhatsApp.
  </Card>

  <Card title="Errori di sincronizzazione HubSpot" icon="bug" href="/troubleshooting/hubspot-sync-failures">
    I problemi di formato del telefono sono la causa più comune di invii falliti.
  </Card>

  <Card title="Messaggi non consegnati" icon="message-x" href="/troubleshooting/messages-not-delivered">
    Diagnostichi i singoli invii che non raggiungono il destinatario.
  </Card>
</CardGroup>
