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
co-authored by
Claude Sonnet 4.6
Claude Sonnet 4.6
parent
8b9029a017
commit
d4325ce037
+2
-129
@@ -1,45 +1,4 @@
|
|||||||
================================================================================
|
========================= FLOW 1 — CICLOS =========================
|
||||||
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.
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
{
|
{
|
||||||
"version": "7.0",
|
"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 ======================
|
||||||
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.
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
{
|
{
|
||||||
"version": "7.0",
|
"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.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user