From d4325ce037c61360f7ae36c83b1409cbbea06a7a Mon Sep 17 00:00:00 2001 From: Lizandro Guarnizo <77708265+lizandrogd@users.noreply.github.com> Date: Wed, 5 Aug 2026 09:13:39 -0500 Subject: [PATCH] docs: dejar en FLOWS-META.txt solo los dos JSON Las instrucciones y notas de verificacion salen del archivo para que el admin copie y pegue directo. Quedan en el historial de git si hacen falta. Co-Authored-By: Claude Sonnet 4.6 --- FLOWS-META.txt | 131 +------------------------------------------------ 1 file changed, 2 insertions(+), 129 deletions(-) diff --git a/FLOWS-META.txt b/FLOWS-META.txt index 1efc7ce..3cd059a 100644 --- a/FLOWS-META.txt +++ b/FLOWS-META.txt @@ -1,45 +1,4 @@ -================================================================================ -CREAR FLOWS DE WHATSAPP — PALMAS360 -Instrucciones para el administrador de Meta Business -================================================================================ - - -CONFIGURACION COMUN --------------------------------------------------------------------------------- - -WhatsApp Manager -> cuenta de WhatsApp Business -> Flows -> Crear flujo - -Para los dos flujos: - - Categoria .......... Otro / Personalizado - Endpoint ........... DEJAR VACIO - Plantilla .......... desde cero (JSON) - -El endpoint vacio es lo importante. Si se configura uno, Meta exige cifrado y -clave publica, y no hace falta: el bot manda los datos al abrir el formulario y -recibe todo al cerrarlo. - - -CUAL PRIMERO --------------------------------------------------------------------------------- - -Ciclos. Es una sola pantalla, sin ranuras ni maximos que definir, y ataca el -paso mas molesto del bot actual: elegir varios lotes hoy son seis mensajes de -ida y vuelta. - - -================================================================================ -FLOW 1 — CICLOS -Nombre: Ciclos -================================================================================ - -Un solo Flow cubre las doce combinaciones (seis tipos de ciclo x abrir/cerrar), -porque el titulo y la lista de lotes los manda el bot en cada envio. - -Sin maximos que definir: el CheckboxGroup es un solo componente cuya lista de -opciones viene de los datos, asi que da igual si la finca tiene 5 lotes o 40. - --------------------------------------------------------------------------------- +========================= FLOW 1 — CICLOS ========================= { "version": "7.0", @@ -109,19 +68,7 @@ opciones viene de los datos, asi que da igual si la finca tiene 5 lotes o 40. } -================================================================================ -FLOW 2 — PLUVIOMETRIA -Nombre: Pluviometria -================================================================================ - -Aca si hay un maximo, y es por una razon tecnica: cada finca lleva un valor -distinto, asi que necesita su propio campo. Hay ocho ranuras y el bot muestra -solo las que existen; las demas quedan ocultas. - -Si alguna empresa llegara a tener mas de ocho fincas, hay que republicar el -Flow con mas ranuras. CONFIRMAR EL MAXIMO ANTES DE PUBLICAR. - --------------------------------------------------------------------------------- +====================== FLOW 2 — PLUVIOMETRIA ====================== { "version": "7.0", @@ -193,77 +140,3 @@ Flow con mas ranuras. CONFIRMAR EL MAXIMO ANTES DE PUBLICAR. } ] } - - -================================================================================ -PUBLICAR -================================================================================ - -Guardar -> Publicar. - -Despues de publicado la estructura no se edita: los cambios son una version -nueva. Por eso conviene definir las ranuras de pluviometria de una vez. - - -================================================================================ -QUE SE NECESITA DE VUELTA -================================================================================ - -Los dos Flow ID. Son numeros largos que aparecen en la lista de flujos o en la -URL al abrirlos. Es lo unico que falta para conectarlos desde el bot. - - Ciclos ............. _______________________ - Pluviometria ....... _______________________ - - -================================================================================ -ANTES DE PUBLICAR — DOS VERIFICACIONES -================================================================================ - -1. VERSION DEL JSON <-- LO UNICO SIN CONFIRMAR - - Esta puesta "7.0" en los dos JSON, pero NO pude confirmar que esa version - exista: las paginas del changelog de Meta no estaban accesibles. - - Lo que si esta documentado es que la 6.1 existe (es la que introdujo el - componente CalendarPicker). - - QUE HACER: el editor de Flows muestra las versiones disponibles al pegar el - JSON. Poner la mas reciente que ofrezca. Si rechaza la 7.0, bajar a 6.1. - - Ninguno de los dos Flows usa componentes nuevos, asi que funcionan igual con - una version anterior. - - El resto del JSON SI esta verificado contra la documentacion oficial: - - DatePicker con init-value en formato YYYY-MM-DD (v5.0+) - - CheckboxGroup con "data-source" y opciones {id, title} - - TextInput con input-type "number" - - "visible" es propiedad valida en los componentes - - Footer con "label" y "on-click-action" - - accion "complete" con "payload" — sintaxis identica a la documentada - - "terminal": true requiere un Footer en la pantalla - -2. MAXIMO DE FINCAS (solo pluviometria) - Hay ocho ranuras. Confirmar que ninguna empresa vaya a superar ese numero, - porque cambiarlo despues obliga a republicar el Flow. - Ciclos no tiene este problema. - - -================================================================================ -NOTAS TECNICAS (para quien conecte el bot) -================================================================================ - -- Los valores __example__ son solo para la vista previa del editor. Los reales - los siembra el bot en flow_action_payload.data al enviar el mensaje. - -- Ambos Flows usan flow_action "navigate" (sin endpoint). La respuesta llega al - webhook como mensaje interactive de tipo nfm_reply, con el contenido en - response_json. - -- En Ciclos, el bot resuelve antes en chat el tipo de ciclo y la accion - (apertura/cierre), porque eso determina que lotes sembrar: apertura ofrece - todos los lotes de la finca, cierre solo los que estan abiertos. - -- Falta construir del lado del bot: envio de mensajes tipo flow en - WhatsAppSender, recepcion de nfm_reply en WpWebhook, y un tipo de flujo que - siembre los datos y arme el POST.