> ## 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. # Formularios > Examinar los formularios HubSpot que Flowella está sincronizando, ver su estado en WhatsApp Flow y activar una sincronización con Meta. 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](/es/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. 3. 3. Genera el JSON equivalente de WhatsApp Flow. 4. 4. 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 abre | Qué ocurre | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/{org}/forms` | Lista 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}/forms` | La 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](/es/essentials/multi-channel#cambiar-de-canal), 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ón | Botón | Qué hace | | ---------------------- | ----------------------- | --------------------------------------------------------------------------------------------- | | Fallido | **Volver a intentarlo** | Vuelve a poner en cola la misma sincronización de formulario. | | En cola / en ejecución | **Cancelar** | Elimina el trabajo con el mejor esfuerzo y marca la ejecución como **`FLOW_SYNC_CANCELLED`**. | | Nunca sincronizado | **Crear** | Ejecuta 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](/es/essentials/status-and-incidents)). * **`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 Conecta el portal desde el que Flowella lee los formularios. Desencadenar flujos desde un flujo de trabajo HubSpot. Recetas integrales que combinan formularios, plantillas y flujos de trabajo. Diagnostique los problemas de sincronización de formularios y los envíos que faltan. Los formularios se sincronizan por canal - comprenda el alcance. Cómo se cifran los formularios en tránsito y en reposo.