1. Compruebe la conexión
1
Abrir Ajustes → HubSpot
Desde la aplicación Flowella, vaya a Configuración → HubSpot.
2
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.
3
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.
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. |
| DUPLICATE_TEMPLATE_SEND_SUPPRESSED | La misma plantilla ya se había enviado al mismo número de teléfono dentro de la ventana de deduplicación de Flowella. Se trata de una protección intencional, no de un fallo de entrega. Consulte Envío de plantilla suprimido como duplicado. |
Template send suppressed as duplicate
Si HubSpot muestra una acción Send WhatsApp Template completada con el motivo de errorDUPLICATE_TEMPLATE_SEND_SUPPRESSED, Flowella omitió el envío de forma intencional porque la misma plantilla ya se había enviado al mismo número de teléfono dentro de su ventana de deduplicación.
El desencadenante más habitual son dos contactos de HubSpot que comparten un número de teléfono — por ejemplo, un registro personal y otro de trabajo, o un hogar con un único número de WhatsApp — que se inscriben en el mismo flujo de trabajo con pocos segundos de diferencia. Solo el primer envío llega a WhatsApp; el segundo se suprime para que el contacto no reciba el mismo mensaje dos veces.
Anteriormente, la segunda acción del flujo de trabajo se quedaba en Pendiente durante alrededor de una hora hasta que expiraba el tiempo de espera del callback de HubSpot. Ahora Flowella completa el callback inmediatamente como un fallo para que el contacto inscrito pase al siguiente paso (o a la rama de “acción fallida”) sin esperar.
Cómo distinguirlo de un fallo real:
- Suprimido como duplicado — el motivo del error es exactamente
DUPLICATE_TEMPLATE_SEND_SUPPRESSED. La plantilla sí se envió a ese número de teléfono, solo que a través de otro contacto inscrito. No hace falta hacer nada. - Fallo de envío real — el error será un motivo específico como
Template not approved,Phone number invalid,Contact opted outo un código de error de Meta Graph. Siga la fila correspondiente de la tabla anterior.
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