KV Store
El KV Store es un almacén clave-valor de sesión. Permite guardar datos entre ejecuciones del mismo usuario en el mismo canal. Útil para estado de sesión, tokens, paso del funnel.
Pasos
- 1Para guardar: usa la tool «KV Guardar» en un nodo de tu flow. Configura la clave y el valor (puede ser una variable del flow).
- 2Para leer: usa «KV Obtener» con la misma clave. El valor queda disponible en {{KV.value}}.
- 3Para borrar: usa «KV Borrar» con la clave.
- 4Para gatear según existencia: verifica {{KV.found}} == true antes de usar {{KV.value}}. Si found es false, value es null.
Referencia
- Scope
- Por (usuario, canal). El mismo usuario en WhatsApp y Telegram tiene KVs separados.
- TTL
- Los valores KV no tienen expiración automática por defecto. Bórralos explícitamente cuando no los necesites.
- {{KV.found}}
- Boolean. true si la clave existe. Siempre gatear sobre found, nunca sobre value directamente.
- {{KV.value}}
- El valor almacenado. null si found es false.
- IDs de tools KV
- Obtén los IDs actuales con list_tools(category='global/all') — busca «KV Guardar», «KV Obtener», «KV Borrar».
Errores comunes
- {{KV.value}} es null cuando debería tener valor
- El gate {{KV.found}}==true no está configurado. Sin el gate, si la clave no existe, la variable sin resolver aborta la ejecución.
- KV no persiste entre sesiones de usuario diferentes
- El scope es por (usuario, canal). Usuarios distintos tienen KVs separados.
Siguiente paso
Lee los gotchas comunes del MCP para evitar errores frecuentes.