> ## 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.

# HubSpot fallos de sincronización

> Diagnostique los envíos de formularios que faltan, las acciones de flujo de trabajo estancadas y las actualizaciones de contactos que no llegan a HubSpot.

La mayoría de los problemas de HubSpot pueden clasificarse en tres categorías: la **integración está desconectada**, la **asignación de campos es incorrecta** o la **acción de flujo de trabajo está mal configurada**. Esta página los analiza en orden.

Para la configuración inicial, consulte [HubSpot setup](/es/hubspot/setup). Para las acciones de flujo de trabajo, consulte [Acciones de flujo de trabajo](/es/hubspot/workflow-actions).

## 1. Compruebe la conexión

<Steps>
  <Step title="Abrir Ajustes → HubSpot">
    Desde la aplicación Flowella, vaya a **Configuración → HubSpot**.
  </Step>

  <Step title="Leer la insignia de estado">
    Un distintivo verde **Conectado** significa que el token OAuth es válido. Un distintivo rojo **Reconnect** significa que el token ha sido revocado o ha caducado.
  </Step>

  <Step title="Vuelva a conectar si es necesario">
    Haga clic en **Reconnect** y vuelva a ejecutar HubSpot OAuth. A continuación, vuelva a intentar la acción que ha fallado.
  </Step>
</Steps>

<Info>
  Causas comunes por las que una conexión HubSpot falla:

  * El usuario HubSpot que autorizó Flowella fue eliminado del portal.
  * HubSpot rotó el token porque no se había utilizado recientemente.
  * Un superadministrador desactivó la integración de Flowella en la configuración de la aplicación de HubSpot.
</Info>

## 2. Los formularios enviados no aparecen en HubSpot

Si un contacto completa un formulario WhatsApp Flow pero no puede ver el envío en HubSpot:

### Desajuste en la asignación de campos

El flujo puede incluir un campo que no se corresponde con una propiedad HubSpot de tipo compatible. Abre el formulario en la página [Formularios](/es/app/forms) y revisa la asignación de cada campo.

### El campo obligatorio está vacío

Si un campo de formulario HubSpot está marcado como obligatorio y el WhatsApp Flow permitió al usuario omitirlo, el envío será rechazado por HubSpot. Haga que el campo sea opcional en HubSpot, u obligatorio en el Flujo.

### Formato del número de teléfono

HubSpot es estricto con el formato del número de teléfono. Véase [Phone number format](/es/hubspot/phone-number-format) - la mayoría de los problemas de "falta de contacto" se reducen a E.164 frente al formato nacional.

### La búsqueda se realiza después de que se ejecute la acción del flujo de trabajo

Si su flujo de trabajo HubSpot se ejecuta inmediatamente después del envío del formulario, las condiciones de carrera pueden hacer que el flujo de trabajo se active antes de que Flowella haya terminado de escribir el contacto. Añada un pequeño retraso (1-2 minutos) al inicio del flujo de trabajo, o active el cambio de propiedad del contacto en lugar del envío del formulario.

## 3. Las acciones del flujo de trabajo se bloquean o fallan

Si un flujo de trabajo HubSpot que incluye una acción Flowella se atasca:

### Abra el historial de acciones del flujo de trabajo.

En HubSpot, busque el contacto, desplácese hasta **Historial de flujos de trabajo** y haga clic en la ejecución que ha fallado. HubSpot muestra la respuesta devuelta por Flowella para cada acción.

### Respuestas de error comunes

\| Error ¿Qué hacer?
\| --- | --- |
\| `Channel not found` | El flujo de trabajo apunta a un canal que ya no existe. Edite la acción y elija un canal actual. Véase [Multicanal](/es/essentials/multi-channel). |
\| `Template not approved` | La plantilla a la que se hace referencia ha cambiado de estado a `REJECTED`, `PAUSED` o `DISABLED`. Véase [Plantilla rechazada](/es/troubleshooting/template-rejected). |
\| `Contact opted out` El contacto se ha dado de baja en este canal. Respete la exclusión, no la anule. |
\| `Phone number invalid` | El teléfono del contacto no está en E.164. Véase [Formato del número de teléfono](/es/hubspot/phone-number-format). |
\| `Subscription required` | Tu plan Flowella no incluye esta acción o tu suscripción ha caducado. Consulta [Facturación](/es/account/billing). |

### La acción existe pero no hace nada

Si el flujo de trabajo se ejecuta sin errores pero no llega ningún mensaje, vuelva a comprobarlo:

* La acción está activada (no en pausa).
* El destinatario está inscrito en el flujo de trabajo en el paso correcto.
* Los criterios de inscripción de HubSpot siguen coincidiendo con el contacto.

## 4. Confusión en la dirección de sincronización

La sincronización de Flowella es **bidireccional pero parcial**:

* Envíos WhatsApp Flow → escribir propiedades de contactos en HubSpot.
* Acciones de flujo de trabajo HubSpot → enviar mensajes y plantillas WhatsApp.
* Respuestas entrantes de WhatsApp → registro en la línea de tiempo del contacto (no actualiza automáticamente las propiedades).

Si esperas que una respuesta WhatsApp de forma libre actualice una propiedad, necesitarás un paso adicional: un flujo de trabajo HubSpot que esté atento al evento de conversación y analice la respuesta, o una integración personalizada a través de la [API](/es/api-reference/introduction).

## ¿Sigues atascado?

<Note>
  Captura lo siguiente antes de contactar con [soporte](https://flowella.io/support):

  * La **fecha de última sincronización** de **Configuración → HubSpot**.
  * El mensaje de error exacto (o captura de pantalla) que devolvió Flowella o HubSpot
  * El ID de contacto y el ID de flujo de trabajo afectados
</Note>