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:
co-authored by
Claude Sonnet 4.6
parent
8b9029a017
commit
d4325ce037
+2
-129
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user