La mayoría de los problemas con HubSpot caen en una de tres categorías: la integración está desconectada, un mapeo de campo es incorrecto o una acción de workflow está mal configurada. Esta página las recorre en orden. Para la configuración inicial, consulta Configuración de HubSpot. Para acciones de workflow, consulta Acciones de workflow.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.
1. Comprobar la conexión
Ve a Settings → HubSpot en la aplicación de Flowella.- Si ves Connected con estado verde, el token OAuth es válido.
- Si ves Reconnect o un banner rojo, tu token ha sido revocado o ha expirado. Haz clic en Reconnect y vuelve a pasar por el OAuth de HubSpot.
- El usuario de HubSpot que autorizó a Flowella fue eliminado del portal.
- HubSpot rotó el token porque no se había usado recientemente.
- Un super admin desactivó la integración de Flowella en los ajustes de apps de HubSpot.
2. Los envíos de formulario no aparecen en HubSpot
Si un contacto completa un Flujo de WhatsApp pero no ves el envío en HubSpot:Desajuste de mapeo de campos
El Flujo puede incluir un campo que no se asocia a una propiedad de HubSpot de tipo compatible. Abre el formulario en la página Formularios y revisa el mapeo de cada campo.Campo obligatorio vacío
Si un campo de formulario de HubSpot está marcado como obligatorio y el Flujo de WhatsApp permitió al usuario saltarlo, HubSpot rechazará el envío. Haz 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 teléfono. Consulta Formato de números de teléfono: la mayoría de los problemas de «contacto faltante» se reducen a E.164 vs formato nacional.El lookup ocurre después de la acción del workflow
Si tu workflow de HubSpot se ejecuta de inmediato al enviarse el formulario, las condiciones de carrera pueden hacer que el workflow se dispare antes de que Flowella termine de escribir el contacto. Añade un retraso corto (1-2 minutos) al inicio del workflow, o dispáralo desde el cambio de propiedad del contacto en lugar del envío del formulario.3. Acciones de workflow atascadas o fallidas
Si un workflow de HubSpot que incluye una acción de Flowella está atascado:Abre el Action history del workflow
En HubSpot, busca el contacto, baja hasta Workflow History y haz clic en la ejecución que falla. HubSpot muestra la respuesta que devolvió Flowella para cada acción.Respuestas de error habituales
| Error | Qué hacer |
|---|---|
Channel not found | El workflow apunta a un canal que ya no existe. Edita la acción y elige un canal actual. Consulta Multicanal. |
Template not approved | La plantilla referenciada ha pasado al estado REJECTED, PAUSED o DISABLED. Consulta Plantilla rechazada. |
Contact opted out | El contacto se ha dado de baja en este canal. Respeta la baja: no la rodees. |
Phone number invalid | El teléfono del contacto no está en E.164. Consulta Formato de números de teléfono. |
Subscription required | Tu plan de 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 workflow se ejecuta sin errores pero no llega ningún mensaje, comprueba:- Que la acción está activada (no pausada).
- Que el destinatario está inscrito en el workflow en el paso correcto.
- Que los criterios de inscripción de HubSpot siguen coincidiendo con el contacto.
4. Confusión con la dirección de la sincronización
La sincronización de Flowella es bidireccional pero parcial:- Envíos de Flujo de WhatsApp → escriben propiedades de contacto en HubSpot.
- Acciones de workflow de HubSpot → envían mensajes y plantillas de WhatsApp.
- Respuestas entrantes de WhatsApp → se registran en la línea de tiempo del contacto (no actualizan propiedades automáticamente).