1. Compruebe la conexión
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.
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.
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 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 - 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. |
| Template not approved | La plantilla a la que se hace referencia ha cambiado de estado a REJECTED, PAUSED o DISABLED. Véase Plantilla rechazada. |
| 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. |
| Subscription required | Tu plan Flowella no incluye esta acción o tu suscripción ha caducado. Consulta Facturación. |
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).
¿Sigues atascado?
Captura lo siguiente antes de contactar con soporte:
- 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