Conecta tu sistema con el CRM.

GET/api/v1/contactos?buscar=marcela&pagina=1&por_pagina=50

Lista los contactos, los más nuevos primero. buscar filtra por nombre, correo o teléfono.

Permiso: contactos:leer (Leer contactos)

{ "datos": [{ "id": "…", "nombre": "Marcela Ríos", "correo": "marcela@ejemplo.co",
  "telefono": "+573001234567", "no_contactar": false, "creado_en": "…" }],
  "pagina": 1, "por_pagina": 50, "hay_mas": false }

GET/api/v1/contactos/{id}

Un contacto por su id.

Permiso: contactos:leer (Leer contactos)

{ "id": "…", "nombre": "Marcela Ríos", … }

POST/api/v1/contactos

Crea un contacto. Si ya hay uno con ese correo o teléfono, lo devuelve (200) en vez de duplicarlo: reintentar es seguro.

Permiso: contactos:escribir (Crear contactos)

{ "nombre": "Marcela Ríos", "correo": "marcela@ejemplo.co", "telefono": "+573001234567", "notas": "Vino de la tienda" }

201 { "id": "…", "nombre": "Marcela Ríos", …, "ya_existia": false }

GET/api/v1/negocios?pagina=1

Lista los negocios con su etapa, monto y contacto.

Permiso: negocios:leer (Leer negocios)

{ "datos": [{ "id": "…", "titulo": "Pedido web #1043", "monto": 238000, "etapa": "Nuevo", "contacto_id": "…" }], … }

POST/api/v1/negocios

Abre un negocio en el embudo. Entra por la primera etapa, o por la que nombres en etapa. El monto va en pesos enteros.

Permiso: negocios:escribir (Crear negocios)

{ "titulo": "Pedido web #1043", "monto": 238000, "contacto_id": "…", "etapa": "Nuevo" }

201 { "id": "…", "titulo": "Pedido web #1043", "monto": 238000, "etapa": "Nuevo", … }

GET/api/v1/productos?buscar=vestido

El catálogo con precio (final, con IVA incluido), tratamiento de IVA y existencias. existencias: null significa que no se controlan.

Permiso: catalogo:leer (Leer el catálogo)

{ "datos": [{ "id": "…", "referencia": "VMA-AZ-L", "nombre": "Vestido midi", "precio": 189900, "iva": "gravado_19", "existencias": 5, "activo": true }], … }

PUT/api/v1/productos/{id o referencia}/existencias

Pone las existencias de un producto, buscado por id o por referencia. Queda en el historial del catálogo como «Vía API». Con 0, el agente lo da por agotado.

Permiso: catalogo:escribir (Actualizar existencias)

{ "existencias": 12 }

{ "id": "…", "referencia": "VMA-AZ-L", "existencias": 12, … }

GET/api/v1/citas?desde=2026-10-01T00:00:00-05:00&hasta=2026-10-31T23:59:59-05:00

Las citas entre dos fechas (hasta 93 días). Sin fechas, las de los próximos 30 días.

Permiso: agenda:leer (Leer la agenda)

{ "datos": [{ "id": "…", "titulo": "Asesoría de estilo", "inicio": "…", "fin": "…", "estado": "confirmada", "contacto_id": "…" }], … }

GET/api/v1/webhooks

Los webhooks registrados y los eventos disponibles.

Permiso: webhooks:gestionar (Gestionar webhooks)

{ "datos": [{ "id": "…", "evento": "lead_captured", "url": "https://…", "activo": true }], "eventos": [ … ] }

POST/api/v1/webhooks

Registra una dirección que recibe un aviso cada vez que pasa el evento. Solo https. Devuelve el secreto para verificar la firma UNA vez.

Permiso: webhooks:gestionar (Gestionar webhooks)

{ "evento": "lead_captured", "url": "https://tu-sistema.com/crm" }

201 { "id": "…", "evento": "lead_captured", "url": "https://…", "secreto": "…" }

DELETE/api/v1/webhooks/{id}

Deja de enviar avisos a esa dirección.

Permiso: webhooks:gestionar (Gestionar webhooks)

204 (sin cuerpo)