Saltar al contenido principal
La página Formularios muestra cada formulario HubSpot que Flowella está siguiendo para su organización, el WhatsApp Flow que Flowella ha construido a partir de cada uno, y si ese Flujo está sincronizado con Meta. Para saber cómo configurar la integración de HubSpot en primer lugar, consulta HubSpot setup. Esta página cubre la pantalla de formularios de la aplicación, no la configuración de la integración.

​
Cómo abrirla

Ve a Formularios en el menú de navegación de la izquierda, o: 
/{org}/forms
También puedes abrir Formularios asignados a un canal específico en /{org}/{waba}/{phone}/forms. La lista es la misma - el alcance del canal se utiliza cuando sincronizas un Flujo con Meta.

​
Lo que muestra la lista

Cada fila representa un formulario HubSpot. Las columnas incluyen:
  • Nombre del formulario y un ID de formulario HubSpot truncado con un botón de copia de un clic.
  • Cuento de campos - cuántos campos tiene el formulario, con una bandera si alguno no está soportado.
  • Última modificación en HubSpot - extraído del propio updatedAt de HubSpot para que pueda saber cuándo cambió la definición del propio formulario.
  • Catalog updated - cuando Flowella actualizó por última vez la definición del formulario desde HubSpot.
  • Estado de WhatsApp Flow - sincronizado, borrador o caducado (HubSpot ha cambiado desde la última sincronización).
  • Crear WhatsApp Flow / Sincronizar WhatsApp Flow - la acción principal. La etiqueta cambia a Sync cuando ya existe un flujo y a Stale - Sync needed cuando el formulario HubSpot se ha editado desde la última sincronización.
El botón está pre-desactivado con un tooltip cuando no se puede ejecutar - por ejemplo: HubSpot no conectado, no hay canal WhatsApp activo, facturación inactiva, o el formulario contiene tipos de campo no soportados. La información sobre herramientas explica exactamente qué requisito previo falta. Si su cuenta HubSpot aún no tiene formularios sincronizados, Flowella instala el catálogo automáticamente en la primera visita, por lo que no tiene que activar una extracción inicial. Puede filtrar y buscar en la lista para encontrar rápidamente un formulario específico.

​
Detalle del formulario

Haga clic en una fila para abrir su página de detalles. La cabecera detallada muestra la misma acción principal Crear / Sincronizar WhatsApp Flow que la fila de la lista, por lo que no tendrá que volver atrás para realizar cambios. Desde la página de detalles puede:
  • Revisar el mapeo campo por campo entre el formulario HubSpot y el WhatsApp Flow.
  • Ver las sincronizaciones anteriores: cuándo se inició cada una, su estado (en cola, en ejecución, correcta, fallida) y cualquier error que haya devuelto Meta.
  • Activa una nueva sincronización, reintenta una ejecución fallida o cancela una sincronización en curso.
  • Abre el flujo correspondiente en Meta Business Suite.

​
Sincronizar un formulario con un WhatsApp Flow

Al hacer clic en Crear WhatsApp Flow o Sincronizar WhatsApp Flow, Flowella:
  1. Ejecuta una comprobación previa - confirma que HubSpot está conectado, que el canal activo está verificado, que el formulario tiene al menos un campo admitido y que la facturación está activa.
  2. Lee la última definición de formulario de HubSpot.
    1. Genera el JSON equivalente de WhatsApp Flow.
    1. Lo carga en Meta en el canal que haya seleccionado (channel-scoped).
  5. Registra la ejecución de la sincronización en la página de detalles.
La mayoría de las sincronizaciones tardan unos segundos. Si Meta rechaza el Flujo, la razón del fallo aparece en la fila de ejecución como un mensaje de error seguro para el usuario (traducido de Meta Graph) - normalmente debido a un tipo de campo no soportado, un problema de verificación en el canal, o un desajuste de categoría. Vuelva a intentarlo desde la misma fila una vez que haya solucionado la causa.

​
Alcance por canal

Los formularios son a nivel de org en la lista, pero están limitados al canal cuando los sincroniza — un flujo debe cargarse contra una combinación específica de WABA + número de teléfono.
URL que abreQué ocurre
/{org}/formsLista todos los formularios que Flowella rastrea. Si hay exactamente un canal de WhatsApp conectado, Flowella lo utiliza automáticamente al sincronizar. Con más de un canal, debe abrir Formularios en un alcance de canal antes de sincronizar.
/{org}/{waba}/{phone}/formsLa misma lista, pero las sincronizaciones se dirigen directamente a este canal. La página espera a que se resuelva el ID de canal en la URL antes de ejecutar sus consultas a HubSpot, de modo que no vea un esqueleto destelleando con resultados del canal equivocado cuando el canal en caché de sesión está obsoleto.
Si hace clic en Sincronizar desde la URL de nivel de org y Flowella no puede decidir qué canal utilizar (sin canales conectados, varios canales sin alcance establecido, o una sesión cruzada de org obsoleta), el botón permanece pre-desactivado con un tooltip explicando qué falta. Cambie al canal correcto desde el conmutador de canales, o abra /{org}/{waba}/{phone}/forms 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 pueda corregir hacia adelante desde la misma fila:
Estado de ejecuciónBotónQué hace
FallidoVolver a intentarloVuelve a poner en cola la misma sincronización de formulario.
En cola / en ejecuciónCancelarElimina el trabajo con el mejor esfuerzo y marca la ejecución como FLOW_SYNC_CANCELLED.
Nunca sincronizadoCrearEjecuta la primera sincronización para este formulario.
La fila también lleva una insignia de error seguro para el usuario:
  • FLOW_SYNC_PREFLIGHT + error de Meta #133010 (teléfono no registrado) — la insignia muestra el mensaje de Meta almacenado y una pista de registro de teléfono, no un genérico “no listo”. Finalice el registro del teléfono en Configuración → Meta y vuelva a intentarlo.
  • QUEUE_FAILED — la cola de sincronización no pudo recoger el trabajo. Normalmente transitorio; vuelva a intentarlo. Si persiste, la página de estado de la plataforma es el próximo lugar para comprobar (consulte Estado e incidentes).
  • validation_errors de Meta — la insignia resume qué campos rechazó Meta, para que pueda ajustar el formulario HubSpot (o el mapeo de campos) y volver a intentarlo sin abandonar la fila.
El historial de ejecuciones se conserva a través de los reintentos, por lo que puede ver cuántos intentos ha realizado un formulario y qué cambió entre ellos.

​
Datos de muestra

Si aún no tiene conexión con HubSpot, la página Formularios se muestra con filas ilustrativas detrás de una llamada “Datos de muestra”. Conecte HubSpot para cambiar a sus formularios reales.
Los formularios HubSpot con tipos de campo no compatibles (carga de archivos, firma) no se pueden sincronizar tal cual. Ajuste el formulario en HubSpot u omita esos campos en WhatsApp Flow.

​
Relacionados

Configuración de HubSpot

Conecta el portal desde el que Flowella lee los formularios.

Acciones del flujo de trabajo

Desencadenar flujos desde un flujo de trabajo HubSpot.

Guías de flujo de trabajo

Recetas integrales que combinan formularios, plantillas y flujos de trabajo.

Fallos de sincronización de HubSpot

Diagnostique los problemas de sincronización de formularios y los envíos que faltan.

Multicanal

Los formularios se sincronizan por canal - comprenda el alcance.

Seguridad de los datos

Cómo se cifran los formularios en tránsito y en reposo.
Última modificación el 27 de junio de 2026