Conecta tu sistema con tu asistente, sin pedirle nada a nadie

Una llave por sistema

Entra a tu panel, menú Integraciones, y crea una llave con un nombre (por ejemplo, el sistema que la va a usar). La llave completa se muestra una sola vez: guárdala en tu sistema. Si la pierdes, revócala y crea otra.

Cada solicitud lleva la llave en la cabecera Authorization:

curl -H "Authorization: Bearer ap_k7f3m2x9q1_a1b2c3..." https://asistentepro.cl/api/v1/cuenta

• Solo lectura: consulta contactos, conversaciones, citas y catálogo.
• Lectura y escritura: además cambia estados, crea citas, reemplaza el catálogo y envía mensajes.
• Una llave solo ve los datos de su propio negocio. Los ids de otra cuenta responden 404.

Siempre JSON, siempre la misma forma

Las respuestas correctas traen ok: true y los datos en data; las listas agregan paginacion. Los errores traen ok: false, un código estable en error y una explicación en message.

{
  "ok": true,
  "data": [
    {
      "id": "clx1...",
      "nombre": "Ana Pérez",
      "contacto": "56912345678",
      "correo": "[email protected]",
      "canal": "whatsapp",
      "estado": "calificado",
      "etapa": "seguimiento",
      "notas": "Quiere cotizar 3 servicios para noviembre.",
      "conversacionId": "clx9...",
      "creadoEl": "2026-10-20T14:03:11.000Z",
      "actualizadoEl": "2026-10-20T14:09:40.000Z"
    }
  ],
  "paginacion": { "pagina": 1, "porPagina": 50, "total": 1 }
}

Las fechas van en ISO 8601 (UTC). Los teléfonos, con código de país y sin signos: 56912345678.

Lo que un sistema externo necesita de verdad

Dirección base: https://asistentepro.cl/api/v1

curl -H "Authorization: Bearer TU_LLAVE" https://asistentepro.cl/api/v1/cuenta

curl -H "Authorization: Bearer TU_LLAVE" "https://asistentepro.cl/api/v1/leads?estado=nuevo&desde=2026-10-01&porPagina=50"

curl -H "Authorization: Bearer TU_LLAVE" https://asistentepro.cl/api/v1/leads/ID_DEL_LEAD

curl -X PATCH -H "Authorization: Bearer TU_LLAVE" -H "Content-Type: application/json" \
  -d '{"estado":"ganado","notas":"Cerró plan anual, factura 1234"}' https://asistentepro.cl/api/v1/leads/ID_DEL_LEAD

curl -H "Authorization: Bearer TU_LLAVE" https://asistentepro.cl/api/v1/conversaciones/ID_CONVERSACION/mensajes

curl -H "Authorization: Bearer TU_LLAVE" "https://asistentepro.cl/api/v1/citas?desde=2026-10-20&hasta=2026-11-20"

curl -X POST -H "Authorization: Bearer TU_LLAVE" -H "Content-Type: application/json" \
  -d '{"titulo":"Visita técnica","inicio":"2026-10-22T15:00:00-03:00","duracionMin":45,"contacto":"56912345678","nombre":"Ana Pérez","correo":"[email protected]","notas":"Revisión anual"}' \
  https://asistentepro.cl/api/v1/citas

curl -H "Authorization: Bearer TU_LLAVE" https://asistentepro.cl/api/v1/catalogo

curl -X PUT -H "Authorization: Bearer TU_LLAVE" -H "Content-Type: application/json" \
  -d '{"productos":[{"nombre":"Queso mantecoso 1 kg","precio":8990,"stock":24,"categoria":"Quesos"},{"nombre":"Jamón serrano 250 g","precio":6490,"stock":0,"categoria":"Cecinas"}]}' \
  https://asistentepro.cl/api/v1/catalogo

curl -X POST -H "Authorization: Bearer TU_LLAVE" -H "Content-Type: application/json" \
  -d '{"contacto":"56912345678","texto":"Tu pedido #482 ya está listo para retiro."}' https://asistentepro.cl/api/v1/mensajes

Te avisamos cuando pasa algo

En Integraciones agrega la dirección https de tu sistema y elige los eventos. Cada vez que ocurra uno, hacemos un POST con JSON a esa dirección. Tu servidor debe responder un código 2xx en menos de 8 segundos; haz el trabajo pesado después de responder.

El cuerpo lleva id (único por aviso, se repite en los reintentos: úsalo para no procesar dos veces), evento, fecha, negocioId y datos con la misma forma que devuelve la API.

POST https://misistema.cl/webhooks/asistentepro
Content-Type: application/json
X-AsistentePro-Evento: cita.creada
X-AsistentePro-Entrega: wh_8f2c...
X-AsistentePro-Timestamp: 1760990000
X-AsistentePro-Firma: 3b1f9c...   (HMAC-SHA256 en hexadecimal)

{
  "id": "wh_8f2c...",
  "evento": "cita.creada",
  "fecha": "2026-10-20T18:00:00.000Z",
  "negocioId": "clorg...",
  "datos": {
    "id": "clx5...",
    "titulo": "Visita técnica",
    "contacto": "56912345678",
    "inicio": "2026-10-22T18:00:00.000Z",
    "duracionMin": 45,
    "estado": "agendada"
  }
}

• Reintentos: si tu servidor no responde 2xx, reintentamos hasta 3 veces en total (de inmediato, 1 minuto después y 5 minutos después). Una redirección (3xx) cuenta como fallo.
• Direcciones: solo https públicas. Direcciones locales o de redes privadas se rechazan al guardarlas y al enviar.
• Probar: el botón "Probar" del panel manda un evento prueba y te muestra qué respondió tu servidor. Las últimas 20 entregas y su estado quedan a la vista.

Comprueba que el aviso viene de AsistentePro

Al crear el webhook te damos un secreto (una sola vez). Cada aviso trae X-AsistentePro-Timestamp (segundos unix) y X-AsistentePro-Firma: el HMAC-SHA256, con tu secreto, del texto <timestamp>.<cuerpo>, en hexadecimal. Calcula lo mismo sobre el cuerpo crudo que recibiste y compara. Descarta avisos con más de 5 minutos.

import crypto from 'node:crypto'

// cuerpoCrudo: el cuerpo EXACTO que llegó (string o Buffer), no el JSON ya parseado y vuelto a serializar.
function firmaValida(secreto, cabeceras, cuerpoCrudo) {
  const ts = Number(cabeceras['x-asistentepro-timestamp'])
  const firma = String(cabeceras['x-asistentepro-firma'] || '')
  if (!ts || Math.abs(Date.now() / 1000 - ts) > 300) return false // más de 5 minutos: se descarta
  const esperada = crypto.createHmac('sha256', secreto).update(`${ts}.${cuerpoCrudo}`).digest('hex')
  const a = Buffer.from(esperada, 'hex'); const b = Buffer.from(firma, 'hex')
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}

Códigos que vas a ver

Límite: 120 solicitudes por minuto por llave (cabeceras X-RateLimit-Limit y X-RateLimit-Remaining). Hasta 10 llaves activas y 10 webhooks por negocio.

¿Necesitas una ruta que no está? Escríbenos desde tu panel: esta primera versión cubre lo que un sistema externo usa de verdad y crece con lo que los negocios piden.