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 <noreply@anthropic.com>
This commit is contained in:
Lizandro Guarnizo
2026-08-05 09:13:39 -05:00
co-authored by Claude Sonnet 4.6
parent 8b9029a017
commit d4325ce037
+2 -129
View File
@@ -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.