> ## 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 de WhatsApp para HubSpot

> Cómo formatear números de teléfono de WhatsApp en HubSpot y Flowella para que coincidan: prefijo internacional, sin espacios y sincronización fiable.

Si utiliza HubSpot para almacenar números de WhatsApp para los flujos de trabajo de Flowella, un formato coherente es esencial. Los números en el formato incorrecto provocan envíos fallidos, y el misterio de "por qué a este número le falta un dígito" es casi siempre un problema de formato. Esta página explica el formato correcto, cómo verificarlo en HubSpot, cómo importar limpiamente y cómo arreglar una hoja de cálculo llena de números desordenados antes de importarlos.

## Use el formato E.164

Almacene todos los números de teléfono de WhatsApp en **formato E.164**:

* Un signo más `+`
* Código de país (sin cero inicial)
* Número nacional completo (sin el `0` troncal inicial)

**Ejemplos:**

* Línea fija del Reino Unido: `+442079460958`
* Móvil del Reino Unido: `+447700900123`

Evite espacios, paréntesis y guiones. HubSpot muestra el formato bien en la interfaz, pero las integraciones —incluida Flowella— funcionan mejor con valores E.164 sin formato.

## ¿Qué propiedad de HubSpot contiene el número de WhatsApp?

Flowella escribe los contactos descubiertos por WhatsApp en una propiedad dedicada —**`hs_whatsapp_phone_number`**— en lugar del campo genérico `phone`.

| Escenario                                                    | Dónde escribe / lee Flowella                                                                                                                                                                                             |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Mensaje entrante de un contacto que aún no existe en HubSpot | Se crea un nuevo contacto de HubSpot con el número de WhatsApp escrito en `hs_whatsapp_phone_number`. La propiedad genérica `phone` se deja vacía.                                                                       |
| Mensaje entrante de un contacto que ya existe                | Flowella busca en `hs_whatsapp_phone_number` **primero**, luego recurre a `phone` / `mobilephone` para los contactos heredados.                                                                                          |
| Saliente desde un flujo de trabajo de HubSpot                | Seleccione `hs_whatsapp_phone_number` en el desplegable **Recipient Phone Number** de cualquier acción de flujo de trabajo de Flowella. Recurrir a `phone` funciona, pero no se recomienda para nuevas automatizaciones. |

<Tip>
  Si tiene contactos existentes cuyo número de WhatsApp está en `phone` o `mobilephone`, cópielo a `hs_whatsapp_phone_number` con un flujo de trabajo de HubSpot o una importación. La búsqueda de Flowella recurre a los campos heredados, pero **la coincidencia entrante es más rápida y fiable cuando el número de WhatsApp está en la propiedad dedicada**.
</Tip>

## Verifique que un número es válido en HubSpot

Cuando hace clic en un campo de teléfono en una ficha de contacto (por ejemplo, **Número de teléfono móvil**), HubSpot muestra un estado bajo la entrada. Quiere que muestre **Validado**.

Si no muestra Validado:

* Compruebe que el número empiece por `+` y el código de país correcto
* Compruebe que **no haya un `0` inicial después del código de país** (por ejemplo, `+4407…` es incorrecto, debería ser `+447…`)
* Use la opción **Eliminar formato del número** de HubSpot si pegó un valor desordenado, y vuelva a guardar

<Tip>
  Un error común en los flujos de trabajo de Flowella es apuntar la acción a la propiedad **Número de teléfono** en lugar de **Número de teléfono móvil**. Verifique cuál propiedad contiene realmente el número habilitado para WhatsApp.
</Tip>

## Consejos para importar CSV y Excel

Excel "ayudará" eliminando el signo `+` o convirtiendo números largos en notación científica. Evítelo antes de importar:

* Dé formato a la columna de teléfono como **Texto** (Inicio → Formato de número → Texto), *y luego* pegue los valores
* O prefije los valores con un apóstrofo en Excel: `'+447700900123` — el apóstrofo fuerza el manejo como texto y no aparecerá en los datos importados
* En archivos CSV, envuelva los valores entre comillas: `"+447700900123"`

No importe números con espacios o paréntesis. HubSpot a menudo puede normalizar el formato, pero los valores E.164 limpios dan los resultados más coherentes.

## Fórmula de Excel: limpiar números de teléfono a E.164

Si tiene una hoja de cálculo llena de números de teléfono en varios formatos, la fórmula a continuación los limpiará al formato E.164, listos para importar a HubSpot.

Maneja todos los formatos de entrada comunes, incluidos:

* Números locales con un `0` inicial (por ejemplo, `07700 900123`)
* Números con `+` y código de país (por ejemplo, `+44 7700 900123`)
* Prefijo de marcación internacional `00` (por ejemplo, `0044 7700 900123`)
* El formato `+44(0)7...`
* Guiones, puntos, paréntesis y otra puntuación
* Números que ya tienen el código de país pero no `+` (por ejemplo, `447700900123`)

<Note>
  Esta fórmula requiere **Excel 365 o Google Sheets**. Utiliza `LET`, `TEXTJOIN` y `SEQUENCE`, que no están disponibles en versiones anteriores de Excel.
</Note>

### Cómo usar la fórmula

1. Copie la fórmula a continuación
2. Péguela en cualquier celda de su hoja de cálculo
3. Cambie `A2` para que apunte a su primera celda de número de teléfono
4. Cambie `"44"` por su código de país (consulte la tabla de referencia a continuación)
5. Cambie `10` por la longitud esperada del número móvil para su país
6. Pulse Enter y luego arrastre hacia abajo para aplicarlo a todas las filas

### La 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 short): "&raw,
  IF(AND(is_domestic, LEN(nsn)>nsn_len),"REVIEW (number too long): "&raw,
  intl))))
)
```

### Qué significan las tres variables de configuración

| Variable       | Qué cambiar                                                                                                                            |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `cell`         | La celda que contiene el número de teléfono sin formato — cámbiela para que coincida con su columna (por ejemplo, `G2`)                |
| `country_code` | El código de país predeterminado para los números nacionales (por ejemplo, `"44"` para Reino Unido, `"1"` para EE. UU.)                |
| `nsn_len`      | La longitud esperada del número de abonado nacional para los números móviles en su país (por ejemplo, `10` para Reino Unido y EE. UU.) |

### Cómo funciona la fórmula

La fórmula toma cuatro caminos diferentes dependiendo de lo que encuentre en la entrada:

1. **Tiene `+` en el original** — ya es internacional; quitar a dígitos y anteponer `+`
2. **Comienza con `00`** — prefijo de marcación internacional; quitar el `00` y anteponer `+`
3. **Comienza con el código de país Y el recuento de dígitos coincide** — internacional sin signo (por ejemplo, `447700900123`); anteponer `+`
4. **Todo lo demás** — número nacional; quitar el `0` inicial y anteponer `+` más el código de país

Antes de todo esto, la fórmula elimina `(0)` de la entrada sin formato, de modo que `+44(0)7700 900123` se gestiona limpiamente.

### Salida de número no válido

Los números que no superan la validación devuelven un mensaje claro para que pueda filtrarlos y corregirlos:

| Salida                                   | Significado                                       |
| ---------------------------------------- | ------------------------------------------------- |
| `REVIEW (not a number): hello world`     | No se encontraron dígitos en absoluto             |
| `REVIEW (number too short): 07700`       | No hay suficientes dígitos para un número válido  |
| `REVIEW (number too long): 077009001234` | Demasiados dígitos, posiblemente un doble prefijo |

La validación de longitud solo se aplica a los números nacionales (los que no tienen `+` o `00`). Los números que ya tienen un prefijo internacional pasan tal cual, ya que la fórmula no puede conocer la longitud del NSN para cada país.

## Referencia de códigos de país

| País                    | Código de país | Longitud NSN (móvil) | Notas                                |
| ----------------------- | -------------- | -------------------- | ------------------------------------ |
| Reino Unido             | 44             | 10                   |                                      |
| Estados Unidos / Canadá | 1              | 10                   | Todos los países NANP comparten cc=1 |
| Francia                 | 33             | 9                    |                                      |
| Alemania                | 49             | 11                   | Solo móvil; las líneas fijas varían  |
| España                  | 34             | 9                    |                                      |
| Italia                  | 39             | 10                   | Los móviles mantienen el 3 inicial   |
| Portugal                | 351            | 9                    |                                      |
| Países Bajos            | 31             | 9                    |                                      |
| Irlanda                 | 353            | 9                    |                                      |
| Grecia                  | 30             | 10                   |                                      |
| Polonia                 | 48             | 9                    |                                      |
| Suiza                   | 41             | 9                    |                                      |
| Turquía                 | 90             | 10                   |                                      |
| India                   | 91             | 10                   |                                      |
| Australia               | 61             | 9                    |                                      |
| Japón                   | 81             | 10                   |                                      |
| China                   | 86             | 11                   |                                      |
| EAU                     | 971            | 9                    |                                      |
| Arabia Saudí            | 966            | 9                    |                                      |
| Sudáfrica               | 27             | 9                    |                                      |
| Brasil                  | 55             | 11                   | Móvil con noveno dígito              |
| Singapur                | 65             | 8                    |                                      |
| Hong Kong               | 852            | 8                    |                                      |

Los valores de longitud NSN anteriores son para números móviles. Para uso de WhatsApp, las longitudes solo de móvil son correctas. Si está procesando una mezcla de números móviles y fijos, tenga en cuenta que algunos países (especialmente Alemania) tienen líneas fijas de longitud variable.

## Lista rápida de solución de problemas

<Tip>
  Si sus acciones de flujo de trabajo de Flowella no entregan los mensajes, repase esta lista:

  * Confirme que la propiedad de HubSpot contiene un valor en **formato E.164** (empieza por `+`)
  * Confirme que el campo muestra el estado **Validado** en HubSpot
  * Asegúrese de que el número incluye el código de país y **no tiene un `0` inicial** después
  * Asegúrese de que su acción de flujo de trabajo apunta a la propiedad correcta — la que realmente contiene el número habilitado para WhatsApp, no a un campo de teléfono diferente
</Tip>

## Relacionado

<CardGroup cols={2}>
  <Card title="Configuración de HubSpot" icon="plug" href="/hubspot/setup">
    Conecte su portal de HubSpot y elija qué propiedades lee Flowella.
  </Card>

  <Card title="Acciones del flujo de trabajo" icon="git-branch" href="/hubspot/workflow-actions">
    Elija la propiedad de teléfono correcta al configurar Enviar plantilla de WhatsApp.
  </Card>

  <Card title="Fallos de sincronización con HubSpot" icon="bug" href="/troubleshooting/hubspot-sync-failures">
    Los problemas de formato de teléfono son la causa más común de envíos fallidos.
  </Card>

  <Card title="Mensajes no entregados" icon="message-x" href="/troubleshooting/messages-not-delivered">
    Diagnostique envíos individuales que no llegan al destinatario.
  </Card>
</CardGroup>
