Tabla de contenido
WhatsApp fluye en los viajes
Un flujo de WhatsApp te permite tener una interacción más estructurada en tus mensajes, como un formulario dentro de WhatsApp. Piense en ello como ofrecer a los clientes una variedad de opciones y luego profundizar en esas opciones a través de varias pantallas para obtener información muy precisa y estructurada. Estas opciones pueden estar en diferentes formatos, como cuadros de texto, selecciones únicas y de opción múltiple, selectores de fechas, etc. (haga clic aquí para obtener una lista completa).
Meta proporciona un ejemplo en el que las empresas guían a los compradores interesados hacia una compra mostrándoles primero una descripción general de alto nivel de los productos disponibles. Luego, los clientes pueden seleccionar sus preferencias para limitarse a un artículo específico y terminar con un enlace para completar el pago.
Creación de un flujo de WhatsApp
Los flujos se pueden crear en Flujos página, en Contenido:
Los flujos de WhatsApp son creado con un lenguaje de codificación llamado Flow JSON.
Ejemplo: creación de un flujo de selector de fecha simple
Cuándo necesita obtener una fecha de un usuario, pedirle que la escriba puede ser problemático. Los usuarios pueden enviar "12-08-2025" "el próximo lunes" o "12 de agosto" lo que requiere que su servicio interprete muchos formatos diferentes. WhatsApp Flows DatePicker resuelve esto presentando un calendario simple e interactivo. Esto mejora la experiencia del usuario y le proporciona una fecha perfectamente formateada en todo momento.
Hay dos pasos principales para que el DatePicker funcione en sus Journeys.
1. Crea un nuevo flujo de WhatsApp
Dale un nombre y selecciona una categoría.
Ahora, simplemente copie y pegue este código en su flujo y guárdelo:
{
"pantallas": [
{
"datos": {},
"id": "PANTALLA_CITA",
"diseño": {
"niños": [
{
"niños": [
{
"etiqueta": "Su fecha de nacimiento",
"nombre": "Fecha_de_nacimiento",
"obligatorio": verdadero,
"tipo": "Selector de fechas",
"texto de ayuda": "Seleccione su fecha de nacimiento"
},
{
"etiqueta": "Continuar",
"acción al hacer clic": {
"nombre": "completo",
"carga útil": {
"fecha": "${form.Date_of_Birth}"
}
},
"tipo": "Pie de página"
}
],
"nombre": "ruta_flujo",
"tipo": "Formulario"
}
],
"tipo": "Diseño de columna única"
},
"terminal": verdadero,
"título": "Fecha de nacimiento"
}
],
"versión": "7.2"
}Para comprender cómo funciona este código, expanda la sección Detalles a continuación:
Detalles
Comprenda las propiedades clave de JSON
Para usar este código de manera efectiva, necesita saber qué hacen las propiedades clave.
id: "APPOINTMENT_SCREEN": Esta es una pieza crucial que se requiere en Turn.io para permitir lo que pantalla de este flujo para iniciar para un usuario, ya que un flujo puede tener varias pantallas.
tipo: "DatePicker": Este es el componente esencial que le indica a WhatsApp que muestre una interfaz de calendario.
nombre: "fecha": Este es el identificador de los datos que obtiene. Después de que el usuario seleccione una fecha y haga clic en "Completar" su servicio recibirá los datos con este nombre (p. ej., {"date": "2025-10-20"}).
etiqueta: "Elija la fecha de su cita": Este es el mensaje de texto que se muestra al usuario encima del selector de calendario.
min-date: "2024-09-06": Esta propiedad se utiliza para la validación. En este ejemplo, evita que el usuario seleccione cualquier fecha antes del 6 de septiembre de 2024.
tipo: "Pie de página" y etiqueta: "Completo": Estas propiedades crean el botón de envío que el usuario tocará para confirmar la fecha seleccionada. Cuando se toca, el flujo se cerrará y enviará los datos de regreso a su servicio.
La documentación completa para los flujos se puede encontrar en Meta.
Una vez guardado el código, puede obtener una vista previa de cómo se vería el flujo para un usuario final en el lado derecho del código de flujo.
Publicar
Si está satisfecho con la experiencia, puede publicar el flujo, lo que luego hace posible usarlo en un Journey.
2. Llame al flujo dentro de un viaje
Después de haber escrito, guardado y publicado el flujo, ahora puede usarlo dentro de los viajes. Hay dos opciones:
2.1 Usar la tarjeta Flow
Simplemente agrega la nueva tarjeta Flow a tu Journey y selecciona el Flow que creaste:
También puedes editar tus flujos directamente desde Journeys:
Si necesita acceder a los resultados de su Flow, simplemente use la referencia de la tarjeta. Por ejemplo, si está recopilando un nombre y una edad, y su tarjeta se llama Flow_1, serán accesibles en @ref_Flow_1.name y
Si tu Flow tiene varias pantallas, también puedes especificar con qué página debe comenzar haciendo referencia al ID de esa pantalla en la barra lateral:
Si durante un flujo el usuario escribe un mensaje, el viaje continuará hasta el "flujo no completado". Si el usuario completa el flujo después de eso, el recorrido no regresará a la ruta de resultados del flujo:
Los flujos también se pueden usar para editar datos existentes. Para hacer eso, puede pasar cualquier dato a un flujo usando los datos Initial data en la barra lateral:
Los flujos también tienen la capacidad de usar expresiones y variables en estos datos. Usar variables para precompletar el flujo puede ser muy poderoso:
En su Flow JSON, también debe esperar estos datos. Debes definir data en la definición de flujo de WhatsApp, así como init-value para cada campo de entrada para el que estás pasando datos iniciales:
{
"versión": "7.2",
"pantallas": [
{
"id": "START_SCREEN",
"título": "Hola mundo",
"terminal": verdadero,
"éxito": cierto,
"datos": {
"nombre": {
"tipo": "cadena",
"__ejemplo__": "Juan"
},
},
"diseño": {
"tipo": "Diseño de columna única",
"niños": [
{
"tipo": "Entrada de texto",
"nombre": "nombre",
"etiqueta": "Nombre",
"valor inicial": "${data.name}"
},
…
]
}
}
]
}2.2 Utilice el bloque de código
La función de código a utilizar que le permite enviar un flujo de WhatsApp es:
whatsapp_flow("Continuar", "su_id_flujo", "APPOINTMENT_SCREEN")Parámetro | Descripción |
Continuar | El texto que se mostrará en el botón que genera el flujo. El flujo solo comienza cuando el usuario hace clic en este botón. |
your_flow_id | Esto se puede encontrar volviendo a la página Flujo desde donde crea un flujo. Cada flujo tiene su "ID de flujo" aparece en esto y puede copiarlo. |
APPOINTMENT_SCREEN | El nombre de la pantalla del flujo que debe mostrarse en este momento. Un único flujo puede tener varias pantallas. Para nuestro código en el Paso 1 solo teníamos esta única pantalla. |
La documentación para usar WhatsApp Flows en Turn.io en diferentes escenarios se puede encontrar aquí. Sin embargo, a continuación se muestra un ejemplo simplista que incorpora el código de flujo que definimos anteriormente.
card Flow do
flujo =
whatsapp_flow("Continuar", "your_flow's_id", "APPOINTMENT_SCREEN") hacer
encabezado("este es el encabezado")
texto("este es el cuerpo")
pie de página("este es el pie de página")
fin
entonces(Gracias cuando has_text(flow.date))
entonces (otro)
fin
tarjeta gracias
text("¡Gracias! Su cita está programada para @flow.date")
fin
tarjeta Otros hacer
text("No seleccionó una fecha.")
endLo anterior le permite enviar un flujo al usuario con un cuerpo de texto, un pie de página, un encabezado y un botón como se muestra a continuación. Por supuesto, puedes optar por no enviar el cuerpo del texto, el pie de página y el encabezado.
Las líneas de código siguientes dentro del código anterior le permite acceder a la fecha en que los usuarios hacen piquetes con el mensaje "@flow.date" variable. Se puede acceder a cualquier variable definida dentro del código de flujo de esta manera una vez que finaliza el flujo. Un viaje no avanzará hasta que el flujo se complete o el usuario lo cancele. Es por eso que puedes ver que verificamos si el usuario realmente seleccionó una fecha y ramificamos nuestro viaje en función de eso.
Plantillas de flujo
Hemos creado algunas plantillas para ayudarte a comenzar. Simplemente dirígete a tu Administrador de WhatsApp, crea un nuevo flujo y pega el código JSON de cualquiera de las plantillas que aparecen a continuación.
Registro de pacientes
{
"pantallas":[
{
"datos":{
},"id":"Registro",
"diseño":{
"niños":[
{
"niños":[
{
"tipo de entrada":"texto",
"etiqueta":"Nombre",
"nombre":"Nombre",
"obligatorio": verdadero,
"tipo":"TextInput"
},
{
"tipo de entrada":"texto",
"etiqueta":"Apellido",
"nombre":"Apellido",
"obligatorio": verdadero,
"tipo":"TextInput"
},
{
"etiqueta":"Cumpleaños",
"nombre":"Cumpleaños",
"obligatorio": verdadero,
"tipo":"Selector de fechas"
},
{
"fuente de datos":[
{
"id":"0_Hombre",
"título":"Hombre"
},
{
"id":"1_Mujer",
"título":"Mujer"
},
{
"id":"2_Otro",
"título":"Otro"
},
{
"id":"3_Prefiero_no_decir",
"título":"Prefiero no decir"
}
],
"etiqueta":"Género",
"nombre":"Género",
"obligatorio": verdadero,
"tipo":"Grupo de botones de radio"
},
{
"text":"¿Quieres recibir mensajes nuestros?",
"tipo":"TextBody"
},
{
"etiqueta":"Sí, quiero recibir mensajes tuyos",
"nombre":"Sí_quiero_recibir_mensajes_de_ti",
"obligatorio": verdadero,
"tipo":"Aceptar"
},
{
"etiqueta":"Completo",
"acción al hacer clic":{
"nombre":"completo",
"carga útil":{
"Nombre":"${form.First_name}",
"Apellido":"${formulario.Apellido}",
"Cumpleaños":"${formulario.Cumpleaños}",
"Género":"${form.Género}",
"Aceptar":"${formulario.Sí_quiero_recibir_mensajes_de_usted}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"terminal": verdadero,
"título":"Registro"
}
],
"versión":"7.2"
}Reserva de citas
{
"pantallas":[
{
"datos":{
},
"id":"Reserva",
"diseño":{
"niños":[
{
"niños":[
{
"fuente de datos":[
{
"id":"0_cita_general","título":"Cita general"
},
{
"id":"1_cita_pediátrica",
"título":"Cita pediátrica"
},
{
"id":"2_Seguimiento",
"título":"Seguimiento"
},
{
"id":"3_Examen",
"título":"Examen"
},
{
"id":"4_Emergencia",
"título":"Emergencia"
}
],
"etiqueta":"Motivo de la visita",
"nombre":"Motivo_de_la_visita",
"obligatorio": verdadero,
"tipo":"Grupo de botones de radio"
},
{
"fuente de datos":[
{
"id":"0_Clínica_A",
"título":"Clínica A"
},
{
"id":"1_Clínica_B",
"título":"Clínica B"
},
{
"id":"2_Clinic_C",
"título":"Clínica C"
}
],
"etiqueta":"Clínica",
"nombre":"Clínica",
"obligatorio": verdadero,
"tipo":"Desplegable"
},
{
"etiqueta":"Fecha preferida",
"nombre":"fecha_preferida",
"obligatorio": verdadero,
"tipo":"Selector de fechas"
},
{
"fuente de datos":[
{
"identificación":"0_8:00-9:00",
"título":"8:00-9:00"
},
{
"identificación":"1_9:00-10:00",
"título":"9:00-10:00"
},
{
"identificación":"2_10:00-11:00",
"título":"10:00-11:00"
},
{
"identificación":"3_11:00-12:00",
"título":"11:00-12:00"
},
{
"identificación":"4_12:00-13:00",
"título":"12:00-13:00"
},
{
"identificación":"5_13:00-14:00",
"título":"13:00-14:00"
},
{
"identificación":"6_14:00-15:00",
"título":"14:00-15:00"
},
{
"identificación":"7_15:00-16:00",
"título":"15:00-16:00"
},
{
"identificación":"8_16:00-17:00",
"título":"16:00-17:00"
},
{
"identificación":"9_17:00-18:00",
"título":"17:00-18:00"
}
],
"etiqueta":"Hora preferida","nombre":"hora_preferida",
"obligatorio": verdadero,
"tipo":"Grupo de casillas de verificación"
},
{
"etiqueta":"Libro",
"acción al hacer clic":{
"nombre":"completo",
"carga útil":{
"Razón_de_la_visita":"${form.Reason_for_visit}",
"Clínica":"${formulario.Clínica}",
"Fecha_preferida":"${form.Fecha_preferida}",
"Hora_preferida":"${form.Preferred_time}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"terminal": verdadero,
"título":"Reserve su cita"
}
],
"versión":"7.2"
}Ingreso de pacientes
{
"pantallas":[
{
"datos":{
},
"id":"visita_actual",
"diseño":{
"niños":[
{
"niños":[
{
"tipo":"Área de texto",
"etiqueta":"Motivo de la visita",
"obligatorio": verdadero,
"nombre":"Motivo_de_la_visita",
"helper-text":"Cuéntanos por qué estás aquí y cualquier síntoma que tengas"
},
{
"tipo de entrada":"texto",
"etiqueta":"Duración del síntoma",
"nombre":"Duración_síntoma",
"obligatorio": verdadero,
"tipo":"Entrada de texto",
"helper-text":"¿Hace cuánto que sientes esto?"
},
{
"etiqueta":"Siguiente",
"acción al hacer clic":{
"nombre":"navegar",
"siguiente":{
"nombre":"Historial_médico",
"tipo":"pantalla"
},
"carga útil":{
"Razón_de_la_visita":"${form.Reason_for_visit}",
"Duración_síntomas":"${form.Symptom_duration}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"título":"Visita actual"
},
{
"datos":{
"Motivo_de_la_visita":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Duración_del_síntoma":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
}
},
"id":"Historial_médico",
"diseño":{
"niños":[
{
"niños":[
{
"text":"Complételos lo mejor que pueda. Omita cualquier cosa de la que no esté seguro.",
"tipo":"TextBody"
},
{
"fuente de datos":[
{
"id":"0_Fatiga","título":"Fatiga"
},
{
"id":"1_Fiebre",
"título":"Fiebre"
},
{
"id":"2_Cambios_de_peso",
"título":"Cambios de peso"
},
{
"id":"3_Chest_pain",
"título":"Dolor en el pecho"
},
{
"id":"4_Tos_/_Dificultad_para_respirar",
"título":"Tos/Dificultad para respirar"
},
{
"id":"5_Náuseas_/_Dolor_abdominal",
"título":"Náuseas / Dolor abdominal"
},
{
"id":"6_dolor_articular_/_dolores_musculares",
"título":"Dolor en las articulaciones / Dolores musculares"
},
{
"id":"7_Dolor de cabeza/Mareos",
"título":"Dolor de cabeza/mareos"
},
{
"id":"8_Ansiedad_/_Depresión",
"título":"Ansiedad / Depresión"
}
],
"etiqueta":"Condiciones recientes",
"nombre":"Condiciones_recientes",
"obligatorio":falso,
"tipo":"Grupo de casillas de verificación"
},
{
"fuente de datos":[
{
"id":"0_Diabetes_(Tipo_1_o_2)",
"título":"Diabetes (tipo 1 o 2)"
},
{
"id":"1_presión_sanguínea_alta",
"título":"Presión arterial alta"
},
{
"id":"2_Asma",
"título":"Asma"
},
{
"id":"3_EPOC",
"título":"EPOC"
},
{
"id":"4_Artritis",
"título":"Artritis"
},
{
"id":"5_Problemas_de_salud_mental",
"título":"Problemas de salud mental"
},
{
"id":"6_Otro",
"título":"Otro"
},
{
"id":"7_Option",
"título":"Opción"
}
],
"etiqueta":"Condiciones crónicas",
"nombre":"Condiciones_crónicas",
"obligatorio":falso,
"tipo":"Grupo de casillas de verificación"
},
{
"fuente de datos":[
{
"id":"0_Sí",
"título":"Sí"
},
{
"id":"1_No",
"título":"No"
}
],"etiqueta":"Hospitalizaciones recientes",
"nombre":"hospitalizaciones_recientes",
"obligatorio":falso,
"tipo":"Grupo de botones de radio"
},
{
"etiqueta":"Medicamentos",
"nombre":"Medicamentos",
"obligatorio":falso,
"tipo":"Área de texto",
"helper-text":"¿Está tomando algún medicamento?"
},
{
"etiqueta":"Alergias",
"nombre":"Alergias",
"obligatorio":falso,
"tipo":"Área de texto",
"helper-text":"¿Alguna alergia conocida?"
},
{
"etiqueta":"Continuar",
"acción al hacer clic":{
"nombre":"navegar",
"siguiente":{
"nombre":"Historia_familiar",
"tipo":"pantalla"
},
"carga útil":{
"Condiciones_recientes":"${form.Recent_conditions}",
"Condiciones_crónicas":"${form.Condiciones_crónicas}",
"Hospitalizaciones_recientes":"${form.Hospitalizaciones_recientes}",
"Medicamentos":"${formulario.Medicamentos}",
"Alergias":"${form.Allergies}",
"Razón_de_la_visita":"${data.Reason_for_visit}",
"Duración_del_síntoma":"${data.Symptom_duration}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"título":"Historial médico"
},
{
"datos":{
"Condiciones_recientes":{
"__ejemplo__":[
],
"artículos":{
"tipo":"cadena"
},
"tipo":"matriz"
},
"Condiciones_crónicas":{
"__ejemplo__":[
],
"artículos":{
"tipo":"cadena"
},
"tipo":"matriz"
},
"hospitalizaciones_recientes":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Medicamentos":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Alergias":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Motivo_de_la_visita":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Duración_del_síntoma":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
}
},
"id":"Historia_familiar",
"diseño":{
"niños":[
{
"niños":[
{
"fuente de datos":[
{
"id":"0_Enfermedad_del_corazón",
"título":"Enfermedad cardíaca"
},
{
"id":"1_Diabetes","título":"Diabetes"
},
{
"id":"2_presión_sanguínea_alta",
"título":"Presión arterial alta"
},
{
"id":"3_Cáncer",
"título":"Cáncer"
},
{
"id":"4_Carrera",
"título":"Accidente cerebrovascular"
},
{
"id":"5_Otras_condiciones_hereditarias",
"título":"Otras condiciones hereditarias"
}
],
"etiqueta":"Historia_familiar",
"nombre":"Historia_familiar",
"obligatorio":falso,
"tipo":"Grupo de casillas de verificación"
},
{
"etiqueta":"Continuar",
"acción al hacer clic":{
"nombre":"navegar",
"siguiente":{
"nombre":"Estilo de vida",
"tipo":"pantalla"
},
"carga útil":{
"Historia_familiar":"${form.Family_history}",
"Condiciones_recientes":"${data.Recent_conditions}",
"Condiciones_crónicas":"${data.Chronic_Conditions}",
"Hospitalizaciones_recientes":"${data.Hospitalizaciones_recientes}",
"Medicamentos":"${datos.Medicamentos}",
"Alergias":"${data.Allergies}",
"Razón_de_la_visita":"${data.Reason_for_visit}",
"Duración_del_síntoma":"${data.Symptom_duration}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"título":"Historia familiar"
},
{
"datos":{
"Historia_familiar":{
"__ejemplo__":[
],
"artículos":{
"tipo":"cadena"
},
"tipo":"matriz"
},
"Condiciones_recientes":{
"__ejemplo__":[
],
"artículos":{
"tipo":"cadena"
},
"tipo":"matriz"
},
"Condiciones_crónicas":{
"__ejemplo__":[
],
"artículos":{
"tipo":"cadena"
},
"tipo":"matriz"
},
"hospitalizaciones_recientes":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Medicamentos":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Alergias":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Motivo_de_la_visita":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
},
"Duración_del_síntoma":{
"__ejemplo__":"Ejemplo",
"tipo":"cadena"
}
},"id":"Estilo de vida",
"diseño":{
"niños":[
{
"niños":[
{
"tipo de entrada":"texto",
"etiqueta":"Ocupación",
"nombre":"Ocupación",
"obligatorio":falso,
"tipo":"TextInput"
},
{
"fuente de datos":[
{
"id":"0_Sí",
"título":"Sí"
},
{
"id":"1_No",
"título":"No"
}
],
"etiqueta":"¿Fumas?",
"nombre":"fumas",
"obligatorio":falso,
"tipo":"Grupo de botones de radio"
},
{
"fuente de datos":[
{
"id":"0_Sí",
"título":"Sí"
},
{
"id":"1_No",
"título":"No"
}
],
"etiqueta":"¿Bebes?",
"nombre":"Bebes",
"obligatorio":falso,
"tipo":"Grupo de botones de radio"
},
{
"fuente de datos":[
{
"id":"0_Frecuentemente",
"título":"Con frecuencia"
},
{
"id":"1_A veces",
"título":"A veces"
},
{
"id":"2_Nunca",
"título":"Nunca"
}
],
"etiqueta":"Hábito de ejercicio",
"nombre":"hábito_de_ejercicio",
"obligatorio":falso,
"tipo":"Grupo de botones de radio"
},
{
"etiqueta":"Completo",
"acción al hacer clic":{
"nombre":"completo",
"carga útil":{
"Ocupación":"${formulario.Ocupación}",
"Fumas":"${form.Fumas}",
"Bebes_bebe":"${form.Bebes_bebes}",
"Hábito_de_ejercicio":"${form.Hábito_de_ejercicio}",
"Historia_familiar":"${data.Family_history}",
"Condiciones_recientes":"${data.Recent_conditions}",
"Condiciones_crónicas":"${data.Chronic_Conditions}",
"Hospitalizaciones_recientes":"${data.Hospitalizaciones_recientes}",
"Medicamentos":"${datos.Medicamentos}",
"Alergias":"${data.Allergies}",
"Razón_de_la_visita":"${data.Reason_for_visit}",
"Duración_del_síntoma":"${data.Symptom_duration}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],"tipo":"Diseño de columna única"
},
"terminal": verdadero,
"título":"Estilo de vida"
}
],
"versión":"7.2"
}Selector de fechas
{
"pantallas":[
{
"datos":{
},
"id":"RECOMENDAR",
"diseño":{
"niños":[
{
"niños":[
{
"etiqueta":"Fecha",
"nombre":"Fecha",
"obligatorio": verdadero,
"tipo":"Selector de fechas"
},
{
"etiqueta":"Enviar",
"acción al hacer clic":{
"nombre":"completo",
"carga útil":{
"screen_0_Birthday_0":"${form.Date}"
}
},
"tipo":"Pie de página"
}
],
"nombre":"ruta_flujo",
"tipo":"Formulario"
}
],
"tipo":"Diseño de columna única"
},
"terminal": verdadero,
"título":"Elige una fecha"
}
],
"versión":"7.2"
}