El módulo se renombró de Forms a Flows en v2.6.31. Los objetos fuente de HubSpot siguen llamándose formularios — el cambio de nombre solo afecta a la entrada de la barra lateral de Flowella, al encabezado de la página y a la URL. Los marcadores a
/{org}/forms siguen funcionando: Flowella emite una redirección 308 permanente a /{org}/flows.Cómo abrirla
Ve a Flows en la navegación de la izquierda, o:/{org}/{waba}/{phone}/flows. La lista es la misma. La limitación por canal se usa cuando sincronizas un Flow con Meta.
Qué muestra la lista
Cada fila representa un formulario de HubSpot. Las columnas incluyen:- Nombre del formulario y un ID de formulario de HubSpot truncado con un botón de copia de un clic.
- Recuento de campos — cuántos campos tiene el formulario, con una marca si alguno no es compatible.
- Última modificación en HubSpot — extraído del propio
updatedAtde HubSpot para que puedas saber cuándo cambió la definición del formulario en sí. - Estado del WhatsApp Flow — sincronizado, borrador u obsoleto (HubSpot ha cambiado desde la última sincronización).
- Indicador de desviación — cuando el formulario de HubSpot se ha editado desde que se construyó por última vez el Flow, la fila muestra una etiqueta ámbar El formulario de HubSpot cambió desde que se construyó este Flow — sincroniza de nuevo para recogerlo. Activa una nueva sincronización para eliminarla.
- Crear WhatsApp Flow / Sincronizar WhatsApp Flow — la acción principal. La etiqueta cambia a Sincronizar cuando ya existe un Flow y a Obsoleto — Sincronización necesaria cuando el formulario de HubSpot se ha editado desde la última sincronización.
Sincronización del catálogo en segundo plano
Flowella mantiene la lista de Flows actualizada automáticamente, para que los formularios de HubSpot recién añadidos o renombrados aparezcan sin que hagas clic en nada:- Cuando abres la página, Flowella sirve el catálogo en caché inmediatamente y pone en cola una nueva sincronización en segundo plano si el catálogo tiene más de 5 minutos.
- Cada 20 minutos, un barrido en segundo plano re-sincroniza el catálogo para cada organización cuya integración con HubSpot esté CONECTADA, para que las listas se mantengan actualizadas incluso para pestañas que nadie ha abierto.
- Mientras se ejecuta una sincronización en segundo plano, el encabezado muestra Actualizando… junto al icono de actualización. Cuando termina, la etiqueta cambia a Última sincronización hace 2 minutos (o el tiempo relativo equivalente). La lista se actualiza en su sitio.
Detalle del formulario
Haz clic en una fila para abrir su página de detalle. El encabezado de detalle muestra la misma acción principal Crear / Sincronizar WhatsApp Flow que la fila de la lista, así no tienes que volver atrás para hacer cambios. Desde la página de detalle puedes:- Revisar el mapeo campo por campo entre el formulario de HubSpot y el WhatsApp Flow.
- Ver las ejecuciones de sincronización pasadas — cuándo se inició cada una, el estado (en cola, ejecutándose, exitosa, fallida) y cualquier error que Meta haya devuelto.
- Activar una nueva sincronización, reintentar una ejecución fallida, o cancelar una sincronización que aún está en progreso.
- Abrir el Flow correspondiente en Meta Business Suite.
- Comprobar de qué versión del formulario de HubSpot se construyó el Flow publicado. Cuando un Flow ha sido sincronizado, el encabezado muestra Flow construido a partir del formulario de HubSpot del 12 sep, 14:03. Compáralo con el valor actual de Última modificación en HubSpot para decidir si necesitas re-sincronizar.
Sincronizar un formulario a un WhatsApp Flow
Cuando haces clic en Crear WhatsApp Flow o Sincronizar WhatsApp Flow, Flowella:- Ejecuta una comprobación previa — confirma que HubSpot está conectado, que el canal activo está verificado, que el formulario tiene al menos un campo compatible y que la facturación está activa.
- Lee la última definición del formulario de HubSpot.
- Genera el JSON de WhatsApp Flow equivalente.
- Lo sube a Meta en el canal que hayas seleccionado (limitado al canal).
- Registra la ejecución de sincronización en la página de detalle y marca la marca de tiempo Flow construido a partir del formulario de HubSpot del para que la desviación pueda detectarse en ediciones posteriores.
Restricción del alcance del canal
Los Flows son a nivel de organización en la lista pero limitados al canal cuando sincronizas — un Flow tiene que subirse contra una combinación específica de WABA + número de teléfono.
Si haces clic en Sincronizar desde la URL de nivel de organización y Flowella no puede decidir qué canal usar (sin canales conectados, múltiples canales sin alcance establecido, o una sesión obsoleta entre organizaciones), el botón se mantiene deshabilitado previamente con una información sobre herramientas que explica qué falta. Cambia al canal correcto desde el selector de canales, o abre
/{org}/{waba}/{phone}/flows directamente.
UX de errores de sincronización
Cuando una sincronización falla, Flowella convierte la fila de ejecución en un único botón de acción con contorno para que puedas corregir hacia delante desde la misma fila:
La fila también lleva un badge de error seguro para el usuario:
FLOW_SYNC_PREFLIGHT+ error de Meta#133010(teléfono no registrado) — el badge muestra el mensaje almacenado de Meta y una pista de registro de teléfono, no un genérico “no listo”. Termina el registro de teléfono en Configuración → Meta y reintenta.QUEUE_FAILED— la cola de sincronización no pudo recoger el trabajo. Normalmente transitorio; reintenta. Si persiste, la página de estado de la plataforma es el siguiente lugar a comprobar (consulta Estado e incidencias).validation_errorsde Meta — el badge resume qué campos rechazó Meta, así puedes ajustar el formulario de HubSpot (o el mapeo de campos) y reintentar sin salir de la fila.
Los envíos de Flow se adjuntan al contacto de HubSpot inscrito
Cuando se envía un WhatsApp Flow desde un workflow de HubSpot, Flowella ahora pasa el ID del contacto de HubSpot inscrito a través del Flow y lo incluye comohs_object_id cuando el envío se escribe de vuelta a HubSpot. Esto hace que el envío se adjunte al contacto exacto que HubSpot inscribió — no a un registro parecido — incluso cuando el número de teléfono coincide con varios contactos, y elimina el último caso en el que la búsqueda de teléfono de HubSpot podría recurrir al registro equivocado.
Si tu organización ya tiene Flows publicados, re-sincroniza cada Flow una vez para que el nuevo campo oculto se incluya en el JSON del Flow subido a Meta:
1
Abre la página Flows
Ve a Flows y abre cualquier formulario cuyo WhatsApp Flow se creó antes de este cambio.
2
Activa una nueva sincronización
Haz clic en Sincronizar WhatsApp Flow en la fila (o la acción principal en la página de detalle). Flowella vuelve a subir el JSON del Flow a Meta con el campo oculto de ID de contacto.
3
Repite para cada formulario activo
Solo los formularios enviados desde workflows de HubSpot necesitan esto. Los formularios enviados fuera del contexto de un workflow no se ven afectados.
Texto de preguntas en bloques de texto enriquecido
HubSpot te permite colocar un elemento de texto enriquecido sobre un grupo de campos para que el texto de la pregunta esté sobre la entrada en lugar de dentro de la etiqueta del campo. Flowella mapea esos bloques al WhatsApp Flow junto con las entradas:
El texto enriquecido aparece antes de las entradas en el grupo de campos, así los clientes ven la pregunta y luego la responden. Las etiquetas de los campos siguen mostrándose en la aplicación, así que mantenlas cortas — consulta Mejores prácticas de diseño de formularios.
Si ya tienes formularios de HubSpot que usan texto enriquecido sobre grupos de campos, re-sincronízalos desde la página de detalle del formulario. Las ejecuciones de sincronización más antiguas solo recogían las etiquetas de los campos, así que el texto de las preguntas en texto enriquecido faltaba en el Flow publicado hasta que sincronices de nuevo.
Formato de la pantalla de agradecimiento
El mismo mapeo HTML → componente de Flow ahora se aplica al texto de agradecimiento en un formulario de HubSpot. Los encabezados, texto en negrita, espacios no separables y listas con viñetas sobreviven a la sincronización en lugar de reducirse a texto plano, y se conserva el pie Hecho.
Cada viñeta se renderiza como una única línea, así el marcado con formato bonito de HubSpot (una
<p> anidada dentro de cada <li>) ya no produce filas de viñeta huérfanas en WhatsApp. Los encabezados de más de 80 caracteres siguen recurriendo a texto de cuerpo, igual que en otras partes del Flow.
Si un formulario se sincronizó antes de este cambio, su Flow sigue llevando el texto de agradecimiento en texto plano. Abre la página de detalle del formulario y re-sincroniza para recoger el nuevo formato.
Datos de muestra
Si aún no tienes conexión con HubSpot, la página Flows se renderiza con filas ilustrativas detrás de un aviso “Datos de muestra”. Conecta HubSpot para cambiar a tus formularios reales.Un formulario puede sincronizarse perfectamente y aun así leerse mal en un teléfono. Las etiquetas de campo largas se acortan en pantalla, más notablemente en iPhone, y el tipo de pregunta equivocado lo empeora. Consulta Mejores prácticas de diseño de formularios antes de construir un formulario.
Relacionado
Configuración de HubSpot
Conecta el portal desde el que Flowella lee los formularios.
Diseño de formularios
Crea formularios de HubSpot que se rendericen limpiamente en cada dispositivo.
Acciones de workflow
Activa Flows desde un workflow de HubSpot.
Guías de workflows
Recetas de extremo a extremo que combinan formularios, plantillas y workflows.
Fallos de sincronización con HubSpot
Diagnostica problemas de sincronización de formularios y envíos faltantes.
Multi-canal
Los Flows se sincronizan por canal — entiende la limitación.
Seguridad de datos
Cómo se cifran los envíos de formularios en tránsito y en reposo.