Saltar al contenido principal

¿Qué es WhatsApp Flows?

  • Actualización

Índice:

  1. Cuál es él¿Flujos de WhatsApp?
  2. Cómo crear flujos a través de las API de comandos Blip
  3. Respecto a los Flujos que necesitan el endpoint del cliente, se denomina canal de datos.
  4. Cómo mostrar sus flujos usando contenido dinámico en el Constructor.
  5. Consideraciones finales

 

¿Qué son los flujos de WhatsApp?

    1. Para qué sirve

WhatsApp Flows es una forma de crear interacciones estructuradas para mensajes comerciales. Con Flows, las empresas pueden definir, configurar y personalizar mensajes con interacciones ricas que brindan a los clientes más estructura en la forma en que se comunican.

Puede utilizar Flows para programar citas, buscar productos, recopilar comentarios de los clientes, obtener nuevos clientes potenciales o cualquier otra cosa en la que la comunicación estructurada sea más natural o cómoda para sus clientes.

 

  1. Consultando la documentación oficial de Meta

Meta proporciona documentación completa con todos los aspectos de la comprensión y la creación de flujos, con ejemplos de código prácticos y cómo ensamblar interfaces y componentes. Utilice esta referencia para crear y probar sus interfaces. Cuando esté listo, puede utilizar las API de Blip para crear e integrar con su contacto inteligente.

  • Documentación de objetivos Aquí

 

  1. ¿Qué aprenderás en este artículo de Blip Help?

Aquí te mostraremos los conceptos básicos para crear y enviar un Flow básico en tu bot, que puedes mejorar para satisfacer tus necesidades.

 

Aprenderás:

  1. Obtener credenciales desde la API de comando de tu bot en Blip.
  2. Crear un flujo, que se creará directamente en su WABA
  3. Flujo de actualización informando al código Flow JSON responsable de ensamblar los componentes y el comportamiento de navegación de tu Flow. (Simulando el HTML utilizado para ensamblar componentes para navegadores web, Flow JSON ensambla componentes que se mostrarán en WhatsApp).
  4. Actualizar la clave pública de un Flow, para que la comunicación entre tu servidor y WhatsApp sea cifrada y segura.
  5. Eliminar o suspender un flujo
  6. Utilice el generador de Blip para enviar tu Flow a tus contactos.

 

Cómo crear flujos a través de las API de comandos Blip

    1. Obteniendo credenciales para acceder a la API

Para utilizar la API de Blip Commands, debe obtener las credenciales en la configuración de su bot. Con estos datos en la mano, podrá utilizar cualquier llamadas HTTP a gestionar sus flujos. Los siguientes ejemplos utilizan la herramienta Postman.

 

Accede al menú información de conexión para obtener:

  • Autorización
  • URL para enviar comandos

 

 

  1. Preparación del entorno:

  2. Puedes descargar una colección de cartero con todas las llamadas aquí descritas. 🠖 Solo descarga aquí

En Postman configura las variables según los datos de tu Bot obtenidos en la sesión de credenciales API.

 

  1. Visión general

Todos los Flows se crean en el WABA del número de WhatsApp. Cada flujo se crea con estado Borrador, lo que significa que aún se encuentra en la fase de desarrollo y debe configurarse y publicarse antes de su uso generalizado.

 

Luego de crear un Flow informando el Nombre y Categoría, debes enviar el archivo JSON del Flow, formato que Meta creó para representar la organización de los componentes visuales dentro de cada pantalla de Flow.

 

Después de actualizar Flow con el código JSON de Flow, puedes probar cómo funciona usando Blip Builder y, cuando todo esté bien con tu Flow, puedes publicarlo en Waba.

 

  • Una vez publicado, Flow no se puede modificar y solo se puede descontinuar/desactivar.
  • Solo es posible editar Flujos en formato Borrador, si está publicado ya no se puede editar.
  • Un Flow que nunca fue publicado podrá ser eliminado de WABA.

  1. Cómo crear un flujo

PEDIDO:

Además de los parámetros básicos de la API del comando Blip como [id],[to],[type] que deben ser los mismos en todas las solicitudes para administrar Flows. Informe:

 

  1. método: colocar
  2. tipo: /flujos-whatsapp
  3. nombre:El nombre de tu flujo
  4. categorías:  [Al menos una categoría es obligatoria]

 

 

RESPUESTA:

En la respuesta recibirás el ID del flujo creado. Esta identificación es importante para todas las demás llamadas posteriores. Al crear el flujo, almacene este ID.

 

Este flujo se creará en WABA vinculado al bot. Con este ID, puede utilizar los otros puntos finales para gestionar este flujo.

 

Este ID también se utilizará en el Blip Builder más adelante, para poder enviar el flujo a tus contactos.

 

 

  1. Listado de sus flujos creados

PEDIDO:

  1. método: conseguir
  2. tipo: /flujos-whatsapp

 

 

RESPUESTA:

En la respuesta, además del nombre y categorías, podrás comprobar:

  1. Oh estado, que inicialmente será BORRADOR, hasta que publiques el Flow.
  2. Tú errores validación, si la hubiera.

 

Estos errores de validación Solo aparecerá después de enviar el código Flow JSON, y si este código presenta algún problema semántico/sintaxis.

 

 

Envío del código JSON de Flow que representa el aspecto de tu Flow

un metacreado para WhatsApp, un nuevo tipo de formato y lenguaje que debes crear para representar la interfaz gráfica de tu Flow. De manera similar al código de marcado HTML, delimita qué componentes y estructura contendrá cada pantalla de flujo.

 

Para comprender más sobre este formato y su aplicación, consulte la documentación oficial de Meta en el portal de desarrolladores. Es importante escribir el código en el formato correcto, prestando siempre atención a los errores de validación.

Actualmente, accediendo a tu Waba tienes un Builder que te ayuda a crear el código correcto en formato Flow JSON, pero este builder no es un requisito para crear tu código Flow JSON. Además, no todos los desarrolladores y clientes tienen acceso a tu Waba, por lo que sólo con las API de Blip podrás crear y gestionar tus Flows.

Cuando ya tengas el código en formato Flow JSON, deberás actualizar tu FLOW creado con este código, para ello simplemente inserta el código en la siguiente solicitud:

PEDIDO:

  1. método: colocar
  2. tipo:/whatsapp-flows/flow-json/{FLUJO_ID}
  • El siguiente código envía un código Flow JSON para crear un hola mundo

 

El código JSON de flujo anterior generará un flujo con el siguiente diseño:

 

RESPUESTA:

 

  1. Obteniendo el enlace de vista previa y más detalles de tu Flow

Para poder ver una vista previa de su flujo, puede utilizar un punto final para obtener el enlace a esta vista previa. El regreso también trae más información relacionada con Waba, donde se creó Flow.

 

PEDIDO:

  1. método: conseguir
  2. tipo:/flujos-whatsapp/{FLUJO_ID}

RESPUESTA:

En la respuesta podrás obtener un enlace para acceder a la vista previa, recordando que este enlace caduco en aproximadamente 30 días. Esta vista previa se muestra en el navegador, mostrando una experiencia aproximada de cómo se mostrará en el teléfono inteligente del usuario.

 

  1. Actualizar el nombre y la categoría de tu flujo

Antes de que se publique, puedes editar toda la información de tu Flow, como Nombre, categorías e incluso el código JSON del Flow.

PEDIDO:

  1. método: colocar
  2. tipo:/flujos-whatsapp/{FLUJO_ID}



RESPUESTA:

 

  1. Para obtener el archivo JSON de Flow actual en su Flow

PEDIDO:

  1. método: conseguir
  2. tipo:/flujos-whatsapp/assets/{FLUJO_ID}

 

RESPUESTA:

Al acceder al enlace resaltado, obtendrás el archivo Flow JSON actual de tu Flow

 

  1. Para publicar su flujo en un estado de uso de producción

Cuando se crea cada Flujo, se crea en formato BORRADOR, es decir: borrador, mientras que en borrador puedes editar este Flujo sin problemas.

Pero para usar Flow definitivamente, debes publicar. Cuando se publica Flow, pasa por aprobaciones en Meta (este proceso es automático y casi instantáneo) y a partir de ahí no se puede editar.

 

¡Atención!

Si necesita eliminar un flujo en estado de BORRADOR, puedes eliminarlo, como te mostraremos a continuación.

Si necesita eliminar un flujo en estado de PUBLICADO, debes marcarlo como DEPRECADO, también lo mostraremos a continuación.

Para publicar un flujo:

PEDIDO:

  1. método: conseguir
  2. tipo:/flujos-whatsapp/publicar/{FLUJO_ID}

 

 

RESPUESTA:

 

  1. Desactivar un flujo publicado

Después de ser publicado, si deseas desactivarlo para que ya no se pueda utilizar:

PEDIDO:

  1. método: conseguir
  2. tipo:/flujos-whatsapp/en desuso/{FLUJO_ID}

 

RESPUESTA:

 

  1. Eliminar un flujo que aún no se ha publicado

Antes de ser publicado, un Flow puede ser eliminado completamente de tu WABA.

Para eso:

PEDIDO:

  1. método: borrar
  2. tipo:/flujos-whatsapp/{FLUJO_ID}

 

RESPUESTA:

 

Respecto a los Flujos que necesitan el endpoint del cliente, se denomina canal de datos.

Un Flow puede tener dos comportamientos:

  1. Todos los datos ingresados/mostrados al usuario viajan entre las propias pantallas de Flujo. Entonces, si en la primera pantalla solicitas datos del usuario, como su nombre, este nombre se puede enviar a una segunda pantalla de Flow, y cuando las pantallas de Flow se cierran, puedes obtener este nombre ingresado a través de tu bot.
  2. Una segunda forma, más sofisticada, es crear una API intermedia dedicada a Flow, que comunicará datos con WhatsApp. Aquí tenemos casos de uso como capturar los datos ingresados ​​por el usuario, enviarlos a esta API de cliente y luego devolver una respuesta al usuario. Ejemplo: un inicio de sesión, donde el usuario escribe nombre de usuario/contraseña, luego su servidor valida estas credenciales y devuelve un resultado al usuario, mostrando una segunda pantalla.

Para que esto suceda, es necesario comprender cómo construir estos flujos y crear el código JSON de flujo en consecuencia, para ello consulte la documentación Meta.

En cualquier caso, para que esto suceda será necesario crear un certificado de cifrado que cifrará todos los datos enviados entre WhatsApp y su API intermedia. La documentación de Meta detalla este tema con más detalle, pero dentro de Blip lo que necesitarás es informar cuál es la clave pública de este cifrado.

Esta clave pública será válida para todos los flujos que cree en el mismo Waba, así que hágalo una vez y cualquier flujo creado en el mismo Waba compartirá esta clave pública.

Para hacer esto, use la solicitud:

PEDIDO:

  1. método: colocar
  2. tipo:/flujos-whatsapp/clave-publica/cargar

Observación:La clave pública del ejemplo no es válida y no debe utilizarse. Reemplácela con la clave generada por usted según la documentación.WhatsApp fluye en Meta.

 

RESPUESTA

 

Cómo mostrar sus flujos usando contenido dinámico en el Constructor.

    1. Creando un bloque y usando Flows enviar mensaje.

Para enviar tu Flow al usuario durante una conversación, debes usar un bloque con contenido dinámico en el constructor.

 

 

 

En contenido dinámico, puedes ingresar el tipo de mensaje que deseas enviar con el siguiente código de ejemplo:

Parámetros que necesita modificar:

  1. id_flujo: el ID del flujo que desea enviar
  2. dentro de [flow_action_payload], el parámetro pantalla, siendo la primera pantalla definida en su archivo Flow JSON
{

  "recipient_type": "individual",

  "messaging_product": "whatsapp",

  "type": "interactive",

  "interactive": {

    "type": "flow",

    "header": {

      "type": "text",

      "text": "Title of buttom CTA"

    },

    "body": {

      "text": "Body of buttom CTA"

    },

    "footer": {

      "text": "Footer of buttom CTA"

    },

    "action": {

      "name": "flow",

      "parameters": {

        "flow_message_version": "3",

        "flow_token": "any_string_for_this_example",

        "flow_id": "10323711744212514",

        "flow_cta": "Open Flow",

     "flow_action": "navigate",

        "flow_action_payload": {

          "screen": "WELCOME_SCREEN",

          "data": {

                    "type": "dynamic_object"

                  }

        }

      }

    }

  }

}

Consideraciones finales

WhatsApp Flows es una nueva característica que continúa evolucionando constantemente. Con el tiempo mejoraremos la experiencia de crear y administrar Flujos en Blip. Sigue las novedades en el foro. Nuevos componentes, nuevas interfaces para acceder al dispositivo, soporte completo para Android e IOS son algunas de las cosas de las que pronto tendremos novedades.

También tendremos extensiones en Blip Store que pueden facilitar/avanzar el proceso de creación de Flows a través de nuestros socios.


Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal.😃

Artículos relacionados