[Extensión] Cómo usar la extensión WhatsApp Flows en Blip

1. Introducción

2. Funcionalidades

3. Instalación y configuración

4. Crear un flow

5. Validar el JSON

6. Configurar el endpoint de datos

7. Previsualizar y probar el flow

8. Publicar el flow

9. Enviar el flow al cliente desde el Builder

10. Buenas prácticas

11. Soporte

Descripción breve: Crea, valida y publica formularios y pantallas interactivas dentro de WhatsApp directamente desde Blip, sin redirigir al cliente a páginas externas.

Introducción

La extensión WhatsApp Flows permite crear, editar, probar y publicar pantallas interactivas que se abren dentro de la conversación en WhatsApp. El cliente llena formularios, elige opciones en menús y completa el recorrido sin salir del chat y sin ser dirigido a una página externa.

Por ejemplo, puedes crear un formulario de citas que se abre en WhatsApp: el cliente selecciona la fecha y la hora, confirma y los datos regresan al flujo del bot en el Builder. Todo el ciclo, desde la edición del JSON del flow hasta la validación, previsualización, prueba y publicación, ocurre en el portal de la extensión.

Funcionalidades

• Creación de flows desde cero y edición del JSON en el editor integrado

• Validación del esquema mientras editas, con un panel que enumera los errores encontrados

• Previsualización del flow antes de publicarlo

• Prueba del flow directamente en WhatsApp, enviando un mensaje a un número

• Configuración del endpoint de datos del flow para el intercambio dinámico de datos con tu servidor

• Claves de cifrado (pública, privada y contraseña) generadas automáticamente para proteger el intercambio de datos con WhatsApp

• Control del estado del flow (Draft, Published y Deprecated), con publicación, desuso y eliminación

Compatible con el canal de WhatsApp.

Instalación y configuración

La extensión depende del número de WhatsApp conectado al bot, porque el envío de los flows se realiza mediante la API de Meta. Instálala en el Router que tenga el canal de WhatsApp activo y usa solo un bot por número.

Atención: si el bot no tiene el canal de WhatsApp activo, la extensión muestra el aviso "Publica tu bot en WhatsApp para usar esta extensión" y no carga la lista de flows.

1. Accede a WhatsApp Flows en Blip Store o busca WhatsApp Flows en Blip Store.

2. Selecciona la extensión y haz clic en Iniciar prueba gratuita.

3. Elige el Router que tenga el canal de WhatsApp activo y completa la instalación.

4. Abre la extensión desde el menú del bot. La extensión muestra la lista de flows del bot.

5. Opcional: haz clic en Ver claves para ver la clave pública, la clave privada y la contraseña. La extensión genera este par de claves durante la instalación y registra automáticamente la clave pública en WhatsApp. Las necesitarás cuando el flow intercambie datos con un endpoint externo.

Crear un flow

1. Haz clic en Crear nuevo flujo y después en Crear desde cero. La extensión crea un flow con estado Draft y abre el editor.

2. Cambia el nombre del flow en el campo de nombre ubicado en la parte superior del editor.

3. Escribe o pega el JSON del flow en el editor. Los cambios se guardan automáticamente. Mientras el flow esté en Draft, puedes editarlo libremente.

Para consultar plantillas de pantallas listas, como formularios, evaluaciones de NPS e inicio de sesión, consulta la documentación de ejemplos de Meta.

Validar el JSON

La extensión valida el esquema del flow mientras editas. El panel junto al editor enumera los errores encontrados o confirma "No se encontraron errores de esquema", junto con el ID y el estado del flow. Corrige todos los errores antes de publicar.

Configurar el endpoint de datos

Si el flow intercambia datos dinámicos con tu servidor, haz clic en Cambiar endpoint en el menú de opciones del editor e informa la URL del endpoint. La extensión usa las claves generadas durante la instalación para proteger este intercambio de datos con WhatsApp. Consulta la referencia del JSON del flow de Meta para ver los campos aceptados.

Previsualizar y probar el flow

Haz clic en Previsualizar para abrir el flow y revisar las pantallas, los textos, los campos y la navegación antes de publicarlo.

Para probarlo directamente en WhatsApp, abre el menú de opciones del editor y haz clic en Probar flujo en WhatsApp. Informa el número de teléfono, el texto del encabezado, del cuerpo y del botón, y envía el mensaje de prueba. La ventana de conversación con ese número debe estar abierta para recibirlo. Mientras el flow esté en Draft, WhatsApp identifica el mensaje como un entorno de simulación, y la personalización de los mensajes solo será válida después de la publicación.

Publicar el flow

1. Abre el menú de opciones del editor y haz clic en Publicar flujo.

2. Espera a que el estado cambie a Published.

Atención: después de publicarlo, el flow no puede editarse ni eliminarse. Para cambiar un flow publicado, crea uno nuevo con el JSON actualizado. Un flow publicado solo puede marcarse como Deprecated mediante la opción Marcar flujo como obsoleto; un flow en Draft puede eliminarse mediante la opción Eliminar flujo.

Enviar el flow al cliente desde el Builder

Después de publicarlo, envía el flow al cliente desde un bloque en el Builder del mismo bot.

1. Copia el ID del flow desde la lista de la extensión o desde el editor.

2. En el Builder, haz clic en +, crea un bloque nuevo y asígnale un nombre claro, como "Enviar WhatsApp Flow".

3. Abre el bloque y agrega un contenido de tipo WhatsApp Flow.

4. Edita el contenido dinámico. En el cuerpo, escribe el mensaje que acompaña al flow. Usa texto fijo sin llaves o una variable entre llaves, como {{variavel}}.

5. En el campo FlowID, pega el ID del flow, sin llaves.

6. En el campo Flow CTA, informa el título del botón que el cliente verá para abrir el flow.

7. En el campo Mode, informa published para flows publicados o draft para pruebas, sin llaves.

8. Guarda los campos.

9. En las Acciones del bloque, configura las solicitudes que preparan el contexto del flow (Reset context y Create Flow context), usando la clave (Key) del bot. Estas solicitudes garantizan que el flow se abra con el contexto correcto y guardan las variables del flow para usarlas posteriormente.

10. Habilita el contexto del Router y publica el bot en el Builder.

Para validar el recorrido completo, envía un mensaje al número de WhatsApp del bot que activa el bloque, abre el flow, llena los campos y confirma que el resultado llegue al Builder con las variables completadas.

Buenas prácticas

• Prueba el flow en un bot de homologación antes de publicarlo en producción.

• Solicita únicamente los datos necesarios en el flow e informa al cliente por qué pides cada dato.

• Al recopilar datos en WhatsApp, cumple con la LGPD y con las políticas de Meta.

Soporte

¿Necesitas ayuda con un flow específico? Dentro del editor, haz clic en Contactar a Wiv para hablar con el equipo de especialistas. Si tienes dudas o problemas con la extensión, escribe a support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o en Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃