Para agentes
Merez es una API con panel. Un agente —Claude, ChatGPT, Codex o el harness que uses— puede leer el catálogo, capturar leads y pedidos y consultar el contenido con un token de Sitio; y, con un token de usuario, escribir el blog, actualizar precios y armar cotizaciones como lo haría una persona, con su rol y su registro.
Documentación técnica en docs.merez.co.
Dos credenciales, dos alcances
No hay una «llave maestra». Hay dos formas de entrar y cada una acota lo que el agente puede tocar.
Para leer y capturar
Vive pegado a un sitio y solo abre las habilidades que le marques. Caduca (90 días por defecto) y se revoca desde el panel. No ve otros negocios y no edita el panel: lee y captura.
Para escribir como una persona
Es el mismo token de la sesión del panel: el agente actúa como ese usuario y hereda su rol. Es el que permite escribir el blog, editar el catálogo y armar cotizaciones, con el límite de permisos de esa persona.
Qué puede tocar
Cada habilidad del token abre un grupo de rutas. Las del token de Sitio son de lectura y captura; la escritura del panel —blog, catálogo, cotizaciones— va con el token de usuario.
Catálogo
Productos, precios, variantes y existencias.
Blog
Entradas, categorías, autores y publicación.
Páginas
Las páginas del sitio y su contenido.
Leads
Crear y consultar leads del sitio.
Pedidos
Pedidos del sitio y su estado.
Bitácora
Entradas cortas ligadas a una oferta.
Certificaciones
Certificados y verificación pública.
Formación
Cursos, aprendices y progreso.
Documentos
Archivos y documentos del sitio.
Medición
Credenciales de analítica y conversiones.
Sitio
Datos públicos del sitio y su configuración.
Fiscal
Emisión del documento fiscal del mostrador.
Cómo se usa
Los dos primeros escriben y usan token de usuario; los dos últimos alcanzan con token de Sitio.
El agente escribe el borrador y lo deja listo; una persona lo revisa y lo publica. La reja de publicación del blog exige título, extracto, meta, imagen y preguntas: el agente no puede saltársela.
Precios, fichas y existencias de cientos de referencias en una corrida, con el mismo contrato que usa el panel. Cada cambio queda en el registro del producto.
Leer pedidos, mover etapas del embudo, crear leads y consultar la bitácora. El agente trabaja sobre el mismo dato que ve el equipo, no sobre una copia.
Lo que llega al cliente se propone, no se envía: el agente redacta y la persona aprueba. Lo reversible se ejecuta; lo que sale al cliente, no.
Se usa en casa
Este blog se publicó así: un agente creó los tres artículos por API con la sesión del equipo, la reja de publicación los validó y quedaron con su portada, sus metadatos y sus preguntas frecuentes. Lo mismo que puede hacer el tuyo.
Sin letra menuda
El token de Sitio está atado a un sitio: no puede leer ni escribir los datos de otro cliente.
Lo que sale al cliente se propone y una persona lo aprueba. El agente redacta; el envío es humano.
Merez no es facturador DIAN. El agente no reemplaza tu facturación ni decide impuestos.
Las operaciones destructivas exigen permiso explícito y quedan en el historial.
Cómo empezar
En Ajustes → Desarrollo, elige el sitio y las habilidades que el agente necesita. Nada más.
Empieza con GET: catálogo, posts, pedidos. Si no lee lo que esperas, no le des escritura.
Si va a escribir, usa un token de usuario con el rol mínimo y activa solo lo que necesita; que una persona revise lo que publica.
El detalle técnico —autenticación, habilidades y errores— está en docs.merez.co.