> ## 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. # Envía tu primer WhatsApp Flow a partir de un formulario de HubSpot > Convierte un formulario de HubSpot en un WhatsApp Flow, añádelo a una plantilla, pruébalo en tu teléfono y después envíalo desde un workflow de HubSpot para que las respuestas lleguen a HubSpot. En este tutorial conviertes un formulario de marketing de HubSpot en un WhatsApp Flow, lo envías a tu propio teléfono y después lo envías desde un workflow de HubSpot. Al terminar, un Flow completado aparece en HubSpot como un envío del formulario original. Requiere unos 50 minutos de trabajo, según las estimaciones de la guía de configuración de Flowella, más hasta 24 horas mientras Meta revisa tu plantilla. ## Antes de comenzar * Lee [Antes de empezar](https://knowledge.flowella.io/es/before-you-start.md) y ten preparado tu acceso a Meta y a HubSpot. * La verificación de la empresa en Meta debe estar completada antes de que puedas crear un Flow en el hito 3. Consulta [Verificación de la empresa](https://knowledge.flowella.io/es/meta/business-verification.md). * Ten a mano tu propio teléfono con WhatsApp, con un número personal y no con el número de empresa que conectas. * Elige o crea un formulario de marketing de HubSpot corto para hacer pruebas. Incluye un campo de correo electrónico: HubSpot usa la dirección de correo electrónico para asociar un envío de formulario a un contacto. * El hito 6 necesita workflows de HubSpot, que se incluyen en los planes Professional y Enterprise de HubSpot. Sin ellos, terminas en el hito 5. Si WhatsApp y HubSpot ya están conectados, pasa directamente al hito 3. ## Cómo encajan las piezas El diagrama muestra el orden en que se crea, se aprueba, se envía y se devuelve a HubSpot un Flow. ```mermaid theme={null} sequenceDiagram actor M as Responsable de marketing participant HS as HubSpot participant F as Flowella participant WA as WhatsApp actor C as Cliente M->>HS: Crea el formulario de marketing HS-->>F: El formulario aparece en la página Flows M->>F: Create WA Flow F->>HS: Lee el formulario F->>WA: Crea o actualiza el Flow y lo publica M->>F: Create template with this Flow F->>WA: Envía la plantilla para su aprobación HS->>F: El workflow ejecuta Send WhatsApp Template F->>C: Mensaje de plantilla con botón de Flow C->>WA: Abre el Flow y lo envía WA->>F: Respuestas F->>HS: Envío del formulario en el contacto asociado F-->>C: Pantalla de agradecimiento o un error que corregir F->>HS: El evento Form Completed inicia los workflows de seguimiento ``` ## Hito 1: conecta WhatsApp y HubSpot Unos 16 minutos. **1. Pon nombre a tu organización** La primera vez que inicias sesión, Flowella te pide que hagas **Name your organisation**. Introduce el nombre y selecciona **Continue**. No puedes conectar WhatsApp hasta que la organización tenga nombre. **2. Conecta WhatsApp** Ve a **Settings → WhatsApp (Meta)** y selecciona **Connect WhatsApp**. En el proceso de registro de Meta, elige o crea tu WhatsApp Business Account (WABA), la cuenta de Meta que contiene tus números y plantillas, y después verifica tu número de teléfono. **3. Conecta HubSpot** Ve a **Settings → HubSpot** y selecciona **Connect HubSpot**. Elige tu cuenta de HubSpot y aprueba la conexión en HubSpot. **Comprueba que ha funcionado:** en la parte superior de la aplicación, los indicadores de estado **WhatsApp** y **HubSpot** muestran **Connected**. En una pantalla pequeña, revisa **Settings → WhatsApp (Meta)**, donde tu número aparece en **Connected WhatsApp numbers**, y **Settings → HubSpot**, que muestra **Connected**. Para más detalles sobre cada paso, consulta [Configurar Flowella](https://knowledge.flowella.io/es/onboarding.md). ## Hito 2: envía tu primer mensaje Unos 2 minutos. 1. Desde tu teléfono, envía cualquier mensaje de WhatsApp a tu número de empresa. Así se abre la ventana de 24 horas, la ventana de atención al cliente de Meta, durante la cual puedes responder sin plantilla. 2. En Flowella, abre **Inbox** y selecciona la nueva conversación. 3. Escribe una respuesta en **Type a message…** y pulsa Intro. **Comprueba que ha funcionado:** la respuesta llega a tu teléfono. Consulta [Inbox](https://knowledge.flowella.io/es/app/inbox.md) para saber más sobre las conversaciones. ## Hito 3: crea el Flow Unos 15 minutos. 1. En HubSpot, crea o elige tu formulario de marketing de prueba. Flowella convierte los campos de texto de una línea, texto de varias líneas, correo electrónico, teléfono, número, desplegable, opción única, casilla de verificación y fecha, y convierte los campos de archivo en un selector de fotos. Omite los campos que no puede convertir, y un campo obligatorio que no puede convertir detiene la sincronización. 2. En Flowella, abre **Flows**. Flowella actualiza la lista de formularios de HubSpot cuando abres la página. Si tu formulario no aparece, selecciona el botón de actualizar de la parte superior de la página. 3. Busca tu formulario y selecciona **Create WA Flow** en la columna **WhatsApp Flow**. El botón muestra **Syncing…** mientras Flowella crea el Flow y lo publica en tu WABA. **Comprueba que ha funcionado:** la fila muestra **Created**, o **Updated** si tu WABA ya tenía un Flow con el mismo nombre, y el botón cambia a **Sync WA Flow**. Selecciona **Open in Meta** para previsualizar el Flow. El Flow tiene una pantalla con las preguntas de tu formulario, titulada con el nombre del formulario, seguida de una pantalla de agradecimiento. Flowella no tiene un editor de Flows: para cambiar las preguntas más adelante, edita el formulario en HubSpot y después selecciona **Sync WA Flow**. Consulta [Flows](https://knowledge.flowella.io/es/app/flows.md) y [Buenas prácticas de diseño de formularios](https://knowledge.flowella.io/es/app/form-design-best-practices.md). ## Hito 4: añade el Flow a una plantilla Unos 5 minutos, más la revisión de Meta. Los contactos abren un Flow desde un botón **Flow** de un mensaje de plantilla, así que el Flow necesita una plantilla. Usa cualquiera de las dos opciones y después envía la plantilla. ### Opción A: empieza desde la página Flows Después de la primera sincronización correcta de tu organización, Flowella muestra **Your form is now a WhatsApp Flow**. Selecciona **Create template with this Flow**. Si no ves el cuadro de diálogo, selecciona **Create template** en la fila del formulario. El editor de plantillas se abre con un botón **Flow** ya conectado a tu Flow. El texto del botón es **Continue**, que puedes cambiar. Escribe el mensaje, elige una **Category** e introduce un **Template name** con letras minúsculas, números y guiones bajos. ### Opción B: empieza desde la plantilla inicial de Flowella 1. En **Templates**, selecciona **New template** y después **View starters** en **Flowella Templates**. 2. Busca `flowella_start_flow` y selecciona **Use this starter**. Su mensaje dice `Hi {{1}}, tap below to complete a short form and we will get back to you.` y su botón de Flow dice **Open form**. 3. En el campo **WhatsApp Flow** del botón, elige tu Flow. Los Flows aparecen con el nombre del formulario de HubSpot del que proceden. 4. En **Body variables**, cambia el **Fallback value** de `{{1}}` de `Alex` a algo que funcione para cualquiera, como `there`. Flowella lo envía cuando un contacto no tiene nombre. La plantilla inicial usa la categoría **Marketing**. Elige la categoría que se ajuste a tu mensaje antes de enviarla. Consulta [Precios y categorías de mensajes de WhatsApp](https://knowledge.flowella.io/es/account/pricing-and-conversation-categories.md). ### Envía la plantilla a Meta 1. Selecciona **Save draft**. 2. Selecciona **Publish Template**, comprueba la categoría y vuelve a seleccionar **Publish Template** para enviarla a Meta. Si el mensaje tiene variables como `{{1}}`, asigna primero a cada una un **Fallback value**. Meta lo revisa como muestra de la variable. Consulta [Variables de plantilla](https://knowledge.flowella.io/es/app/template-variables.md#valores-de-respaldo). 3. Espera a que el estado cambie de **Pending** a **Approved**. Meta indica que la decisión puede tardar hasta 24 horas. **Comprueba que ha funcionado:** el estado de la plantilla es **Approved**. Si Meta la rechaza, consulta [Plantilla rechazada](https://knowledge.flowella.io/es/troubleshooting/template-rejected.md). ## Hito 5: prueba el Flow en tu teléfono Unos 3 minutos. 1. Abre tu plantilla aprobada y ve a la pestaña **Send**. 2. En **Test Template**, elige tu **Country**, introduce tu **WhatsApp Number** y rellena las variables de la plantilla. 3. Selecciona **Send Test**. 4. En tu teléfono, abre el mensaje y toca el botón de Flow. Rellena el formulario con tu propia dirección de correo electrónico y envíalo. **Comprueba que ha funcionado:** * WhatsApp muestra la pantalla de agradecimiento con el mensaje de agradecimiento de tu formulario de HubSpot. * En el **Inbox** de Flowella, la conversación muestra una tarjeta con tus respuestas, marcada como **Response sent**. El título de la tarjeta es el texto del botón de Flow, o **Flow response**. * En HubSpot, el formulario tiene un nuevo envío desde una página con el nombre del formulario, por ejemplo `WhatsApp Flow · Contact us`. HubSpot actualiza las propiedades de contacto asignadas en el formulario. * La cronología del contacto muestra un evento **Form Completed** con un enlace **View submission**. Flowella envía las respuestas al formulario original de HubSpot. El envío y las propiedades del contacto aparecen en HubSpot igual que si el formulario se hubiera rellenado en tu sitio web. > [!NOTE] > > Esta prueba también marca **Send a Flow from HubSpot** en la guía de configuración, porque ese paso cuenta cualquier Flow completado. ## Hito 6: envía el Flow desde un workflow de HubSpot Unos 10 minutos. > [!NOTE] > > Este hito necesita acciones de workflow de HubSpot, que requieren un plan de HubSpot que incluya workflows (Professional o Enterprise). En Flowella, abre **Settings → HubSpot** y comprueba que **Custom workflow actions** aparece en **Unlocked**. Si no aparece, has terminado en el hito 5: envía los Flows desde Flowella con un envío de prueba o un [envío masivo](https://knowledge.flowella.io/es/app/bulk-send.md). **1. Prepara un contacto de prueba** En HubSpot, usa un contacto con tu propio número de WhatsApp en formato internacional, como `+447700900123`, y tu dirección de correo electrónico. Es posible que el mensaje que enviaste en el hito 2 ya haya creado o vinculado un contacto para tu número. Consulta [Formato del número de teléfono](https://knowledge.flowella.io/es/hubspot/phone-number-format.md). **2. Crea un workflow basado en contactos** Las acciones de Flowella solo se ejecutan sobre contactos. Define un desencadenante de inscripción que, por ahora, solo cumpla tu contacto de prueba, como un valor de propiedad o una lista. **3. Añade Send WhatsApp Template** Añade la acción **Send WhatsApp Template** de Flowella. En **Template Name**, elige tu plantilla de Flow. Solo aparecen en la lista las plantillas aprobadas. En **Contact Phone Number**, selecciona la propiedad de contacto que contiene el número de WhatsApp. Si tu plantilla tiene una variable, asigna una propiedad como el nombre a **Template Variable 1**. Consulta [Send WhatsApp Template](https://knowledge.flowella.io/es/hubspot/workflow-actions.md#send-whatsapp-template). **4. Espera al Flow** Añade un paso **Delay until event** con el evento **Form Completed** de Flowella. Fíltralo por **Form Name** para que coincida con el nombre de tu formulario de HubSpot y define cuánto tiempo esperar, por ejemplo un día. **5. Decide qué ocurre después** Para los contactos que completan el Flow, crea una rama según las propiedades de contacto que escribió el formulario, o crea una tarea. El evento **Form Completed** registra el nombre y el origen del formulario, no las respuestas. Para los contactos que no lo completan a tiempo, envía una plantilla de recordatorio o crea una tarea. **6. Activa el workflow** Activa el workflow e inscribe tu contacto de prueba. **Comprueba que ha funcionado:** * La plantilla llega a tu teléfono y el historial de workflows del contacto muestra la acción **Send WhatsApp Template** como completada. Flowella completa la acción cuando WhatsApp informa del primer estado del mensaje, normalmente enviado. * Después de completar el Flow, el contacto avanza desde el paso **Delay until event** y el envío aparece en el formulario de HubSpot como en el hito 5. * En la guía de configuración, **Send a template from HubSpot** está marcado. **Form Completed** solo se activa cuando alguien envía un WhatsApp Flow a través de Flowella, nunca con los envíos del mismo formulario desde el sitio web. Para ver workflows completos basados en este patrón, consulta las [guías de workflows](https://knowledge.flowella.io/es/hubspot/workflows/overview.md). ## Solución de problemas > **Create WA Flow aparece atenuado** > > Pasa el cursor sobre el botón para ver el motivo. El mensaje más habitual es "Meta business verification is required before publishing flows." El botón tampoco está disponible cuando WhatsApp no está conectado, cuando el formulario no tiene campos compatibles con WhatsApp Flows o cuando tu plan no permite sincronizar. Consulta [Flows](https://knowledge.flowella.io/es/app/flows.md) y [Problemas de onboarding](https://knowledge.flowella.io/es/troubleshooting/onboarding.md). > **La sincronización falla** > > La fila muestra una etiqueta como **Not ready**. Pasa el cursor sobre el icono de información que hay al lado para ver el motivo. Si un campo obligatorio de HubSpot no se puede recoger en un WhatsApp Flow, haz que el campo sea opcional o cambia su tipo en HubSpot y después selecciona **Try again**. Consulta [Flows](https://knowledge.flowella.io/es/app/flows.md). > **Mi formulario no está en la página Flows** > > Selecciona el botón de actualizar de la parte superior de **Flows**. Solo aparecen los formularios de marketing de HubSpot. Si la página muestra **Sample forms**, Flowella todavía no puede leer tus formularios de HubSpot: comprueba la conexión en **Settings → HubSpot**. Consulta [Flows](https://knowledge.flowella.io/es/app/flows.md). > **La plantilla no aparece en la lista de la acción de HubSpot** > > Solo aparecen las plantillas con el estado **Approved**. Espera a la decisión de Meta y vuelve a abrir la acción. Consulta [Acciones de workflow de HubSpot](https://knowledge.flowella.io/es/hubspot/workflow-actions.md). > **El Flow muestra un error al enviarlo** > > "Missing required field" suele significar que se añadió un campo obligatorio al formulario de HubSpot después de la última sincronización. Selecciona **Sync WA Flow** en la página **Flows** y vuelve a enviar el Flow. "Could not submit to HubSpot. Try again." significa que HubSpot no aceptó el envío: inténtalo de nuevo y comprueba que **Settings → HubSpot** muestra **Connected**. > **El envío no está asociado a un contacto** > > HubSpot asocia los envíos de formularios a los contactos por dirección de correo electrónico. Añade un campo de correo electrónico al formulario o asegúrate de que el contacto tiene una dirección de correo electrónico en HubSpot. > **La acción Send WhatsApp Template falla** > > Abre el historial de workflows del contacto para ver el motivo que indica Flowella. Un número que falta o con un formato incorrecto falla con `CONTACT_PHONE_MISSING` o `CONTACT_PHONE_INVALID`. Consulta [Formato del número de teléfono](https://knowledge.flowella.io/es/hubspot/phone-number-format.md) y [Acciones de workflow de HubSpot](https://knowledge.flowella.io/es/hubspot/workflow-actions.md). ## Relacionado > **[Flows](https://knowledge.flowella.io/es/app/flows.md)** > > Estado de sincronización, conversión de campos y límites de los WhatsApp Flows. > **[Plantillas](https://knowledge.flowella.io/es/app/templates.md)** > > Crea, prueba y envía plantillas de WhatsApp. > **[Acciones de workflow de HubSpot](https://knowledge.flowella.io/es/hubspot/workflow-actions.md)** > > Todas las acciones y eventos de Flowella disponibles en los workflows de HubSpot. > **[Guías de workflows](https://knowledge.flowella.io/es/hubspot/workflows/overview.md)** > > Recetas de workflows de HubSpot listas para usar que utilizan Flows. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.