Síntoma / Necesidad

Necesito implementar interacciones guiadas y dinámicas con mis clientes a través de WhatsApp, como encuestas, formularios de registro, o procesos de agendamiento de citas, y automatizar estas conversaciones sin la intervención directa de un agente. Las plantillas de mensaje estándar no son suficientes para la complejidad de estas interacciones.

Contexto / Escenarios

Las 'Flow Templates' de WhatsApp (también conocidas como Meta Flows) son una herramienta poderosa para crear experiencias conversacionales interactivas y estructuradas. Son ideales para escenarios donde se requiere:

• Recopilar información: Realizar encuestas de satisfacción, obtener datos de clientes para registros, o actualizar perfiles de usuario.
• Guiar al usuario a través de un proceso: Como agendar una cita, seleccionar opciones de un menú extenso, o cotizar un servicio de manera interactiva.
• Automatizar acciones: Permitiendo al cliente completar un proceso directamente desde WhatsApp, reduciendo la necesidad de cambiar a otras plataformas o de interacción humana.

En Wolkvox Manager, esta funcionalidad se integra a través de los routing points de tipo ChatBot en Wolkvox Studio, utilizando el componente "Responder Chat" con conectores de WhatsApp de tipo Cloud API. Es fundamental entender que la plantilla del 'Flow' debe ser creada y aprobada previamente en Meta Business Manager.

Nota: Para consultar la documentación oficial de Meta acerca de las plantillas Flow da [clic aquí].

Respuesta (Solución / Recomendación)

Para enviar una plantilla 'Flow Template' a WhatsApp utilizando Wolkvox Studio, debes seguir estos pasos clave:

Paso 1: Creación y Aprobación de la Plantilla 'Flow' en Meta Business Manager (Requisito Indispensable)

Primero, la plantilla de tipo 'Flow' debe ser diseñada, creada y aprobada en tu cuenta de Meta Business Manager, en los tipos de plantilla marketing o utilidad en la opción “Flow”. Wolkvox Studio no permite la creación de la plantilla de 'Flow'; solo facilita su envío. 

Paso 2: Configuración en Wolkvox Studio (Routing Point ChatBot)

Una vez que tu plantilla 'Flow' está aprobada en Meta, puedes configurarla para ser enviada desde tu ChatBot en Wolkvox Studio.

1. Ingresa a wolkvox Studio: 
   1. Accede a tu Wolkvox Manager.
   2. En el menú lateral izquierdo, navega hasta "Wolkvox Studio" (el apartado donde diseñas tus flujos).
   3. Abre el routing point de tipo ChatBot donde deseas enviar el 'Flow'.
   4. Agrega el componente “Responder Chat”. 
   5. Desde la paleta de componentes, arrastra y suelta el componente "Responder Chat" (o "Reply Chat") en tu flujo de diseño. Conéctalo a la lógica de tu ChatBot en el punto deseado (ej. después de un saludo inicial o una pregunta específica).
   6. Haz doble clic en el componente "Responder Chat" para abrir su ventana de configuración.
2. Ve a la pestaña "Avanzado".
3. En el campo "Plantillas", haz clic en el desplegable y selecciona “Flow template (api cloud)” aprobada en Meta Business Manager.
4. Haz clic en el botón "Cargar plantilla". Esto cargará automáticamente la estructura JSON mínima necesaria para tu 'Flow'.
5. Ajusta el JSON para los Parámetros del Flow: El campo de texto en el componente "Responder Chat" mostrará una estructura JSON similar a esta:

{
    "type": "flow",
    "name_template": "tu_nombre_de_flow_aqui",
    "params": [
    	"param1",
    	"param2"
    ],
    "language": "es_MX"
}

• type: NO MODIFICAR. Siempre debe ser "flow".
• name_template: Nombre de la plantilla de flujo creada previamente en Meta Business. Este campo debe coincidir con el nombre de una plantilla existente.
• params (variables): Aquí es donde debes CONFIGURAR los parámetros o variables que tu plantilla incluya. Deben ir separados por coma.
• language: Este valor debe coincidir con el idioma de la plantilla aprobado en Meta (ej. "es_MX").

6. El checkbutton “Continuar chatbot” debe estar desmarcado.
7. Guarda los Cambios: Una vez que hayas configurado el JSON con los parámetros adecuados, haz clic en el botón "Guardar" en la ventana de configuración del componente.

Casos de ejemplo

En wolkvox Studio, las plantillas de tipo flujo (Flow Template) permiten una interacción estructurada y automatizada con los usuarios a través de WhatsApp. A continuación, se presentan varios ejemplos de cómo configurar estas plantillas según diferentes escenarios, incluyendo la presencia o ausencia de parámetros y el uso de encabezados multimedia.

Caso 1: Plantilla sin parámetros y lenguaje "Spanish" sin encabezado multimedia:

{
	"type": "flow",
	"name_template": "template",
	"language": "es"
}

Caso 2: Plantilla con un parámetro y lenguaje "English" sin encabezado multimedia:

{
	"type": "flow",
	"name_template": "template",
	"params": [
		"first parameter"
	],
	"language": "en"
}

Caso 3: Plantilla con dos parámetros y lenguaje "English (US)" sin encabezado multimedia:

{
	"type": "flow",
	"name_template": "template",
	"params": [
		"first parameter",
		"second parameter"
	],
	"language": "en_US"
}

Caso 4: Plantilla con encabezado multimedia tipo imagen:

{
	"type": "flow",
	"name_template": "template",
	"header_media_type": "image",
	"header_media_link": "https://images.unsplash.com/photo-1472491235688-bdc81a63246e",
	"language": "en"
}

Caso 5: Plantilla con encabezado multimedia tipo video:

{
	"type": "flow",
	"name_template": "template",
	"header_media_type": "video",
	"header_media_link": "https://test-videos.co.uk/vids/jellyfish/mp4/h264/360/Jellyfish_360_10s_MB.mp4",
	"language": "en"
}

Caso 6: Plantilla con encabezado multimedia tipo documento:

{
	"type": "flow",
	"name_template": "template",
	"header_media_type": "document",
	"header_document_name": "document.pdf",
	"header_media_link": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
	"language": "en_US"
}