# API de Clonify

> Conecta tu sistema (tu CRM, tu app, Make…) con tu cuenta de Clonify: lee tus conversaciones, contactos y transcripciones, y construye desde fuera. Sube contenido a tu Conocimiento y crea productos, preguntas frecuentes y clones. La API habla JSON sobre HTTPS y usa las mismas reglas que el panel: tus cuotas y candados de plan se respetan solos.

- URL base: https://www.clonify.com/api/v1
- OpenAPI: https://developers.clonify.com/developers/openapi.json (en: ?lang=en, ca: ?lang=ca)
- Docs: https://developers.clonify.com/developers

## Empezar

- Autenticación: Para conectar un chat elige Solo conversar. Crea tu llave en el panel: Configuración → Claves de API y webhooks. Puedes tener varias (una por sistema conectado), cada una con permisos de solo lectura, de lectura y escritura, o totales (con borrado). La llave se muestra UNA sola vez: guárdala como una contraseña. Envíala en cada petición en la cabecera Authorization.
- Límites de peticiones: Cada cuenta tiene un cupo de peticiones por minuto según su plan: 60 (Starter), 120 (Pro) o 300 (Scale), compartido entre todas sus llaves. Cada respuesta incluye las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Al superarlo recibes 429 con Retry-After (espera y reintenta con backoff). El límite corta scripts descontrolados, no uso real: a 120/min se exportan 12.000 conversaciones por minuto.
- Paginación: Los listados grandes se recorren por cursor: pide con ?limit= y encadena ?starting_after=<último id> mientras has_more sea true. El cursor es estable por id: puedes recorrer todo el histórico sin perder ni duplicar elementos. Los catálogos acotados (etiquetas, clones, productos) llegan enteros en una respuesta.
- Webhooks: Además de leer bajo demanda, Clonify puede avisarte en tiempo real: configura tu URL en Configuración → Claves de API y webhooks y recibirás lead.created (nuevo contacto captado por el clon), conversation.ended (conversación real terminada tras 10 minutos sin mensajes, con sus mensajes; las pruebas del panel no se envían) y purchase.created (cada compra registrada, con el correo de quien compra, el producto y el importe). Cada aviso se activa por separado. Cada envío va firmado con HMAC-SHA256 en la cabecera de firma usando tu secreto whsec_…. Verifica la firma antes de procesar.

## Referencia de la API

### Seguimiento de alumnos
- GET /api/v1/products/{id}/students — Listar los alumnos de un curso y cómo van
- GET /api/v1/learning/playback — Consultar reproducción de vídeos
- GET /api/v1/learning/attendance — Consultar conexiones a mesas de grupo
- GET /api/v1/learning/events — Consultar evidencias de aprendizaje
- GET /api/v1/learning/sessions — Consultar sesiones de clase
- GET /api/v1/products/{id}/feedback/responses — Listar respuestas de feedback de un curso

### Entregas externas por API
- GET /api/v1/external-delivery/connections — Conexiones de entrega externa
- POST /api/v1/external-delivery/connections — Guardar conexión de entrega externa
- GET /api/v1/external-delivery/rules — Reglas de entrega externa
- POST /api/v1/external-delivery/rules — Guardar regla de entrega externa
- GET /api/v1/external-delivery/deliveries — Estado de entregas externas
- POST /api/v1/external-delivery/deliveries/{id}/retry — Reintentar entrega externa

### Chat con el clon
- POST /api/v1/chat — Hablar con el clon

### Contactos y etiquetas
- GET /api/v1/contacts — Listar contactos
- POST /api/v1/contacts — Crear o actualizar un contacto
- GET /api/v1/contacts/{id} — Leer un contacto
- DELETE /api/v1/contacts/{id} — Borrar un contacto
- GET /api/v1/tags — Listar etiquetas

### Accesos de academias
- GET /api/v1/access/mappings — Listar relaciones de cursos externos
- POST /api/v1/access/mappings — Relacionar un curso externo
- DELETE /api/v1/access/mappings — Quitar una relación de curso
- POST /api/v1/access/sync — Sincronizar los accesos de una persona

### Conversaciones
- GET /api/v1/conversations — Listar conversaciones
- GET /api/v1/conversations/{id} — Leer una conversación
- POST /api/v1/conversations/reviewed — Marcar conversaciones como revisadas
- DELETE /api/v1/visitors/{anon_id} — Borrar un visitante y todo su historial

### Catálogo de productos
- GET /api/v1/products — Listar productos
- POST /api/v1/products — Crear un producto
- GET /api/v1/products/{id} — Leer un producto
- PATCH /api/v1/products/{id} — Editar un producto
- POST /api/v1/products/{id}/entries/import — Importar entradas de contenido
- GET /api/v1/products/{id}/entries/import — Consultar una importación
- PATCH /api/v1/products/{id}/entries/import — Actualizar la presentación de entradas
- GET /api/v1/products/{id}/faqs — Listar FAQs de un producto
- POST /api/v1/products/{id}/faqs — Crear FAQ de producto
- DELETE /api/v1/products/{id}/faqs/{faqId} — Borrar FAQ de producto
- DELETE /api/v1/products/{id} — Borrar un producto

### Ventas externas
- POST /api/v1/sales — Registrar una venta cobrada fuera
- POST /api/v1/sales/refund — Registrar una devolución

### Conocimiento
- GET /api/v1/brain/sources — Listar fuentes del conocimiento
- POST /api/v1/brain/sources — Entrenar al clon con texto
- POST /api/v1/brain/sources/link — Entrenar al clon con un enlace
- POST /api/v1/brain/sources/pdf — Entrenar al clon con un PDF
- GET /api/v1/brain/sources/{id} — Leer una fuente
- DELETE /api/v1/brain/sources/{id} — Borrar una fuente
- DELETE /api/v1/brain/sources — Borrar una fuente por tu id
- GET /api/v1/brain/folders — Listar carpetas del conocimiento
- POST /api/v1/brain/folders — Crear una carpeta
- GET /api/v1/brain/guided-answers — Listar respuestas
- POST /api/v1/brain/guided-answers — Crear respuesta
- DELETE /api/v1/brain/guided-answers/{id} — Borrar respuesta

### Multimedia
- GET /api/v1/assets — Listar Multimedia
- POST /api/v1/assets — Subir un archivo a Multimedia
- GET /api/v1/assets/{id} — Leer un asset de Multimedia
- GET /api/v1/assets/{id}/download — Descargar los bytes de un asset

### Clones (versions en la API)
- GET /api/v1/versions — Listar clones
- POST /api/v1/versions — Crear un clon
- PATCH /api/v1/versions/{id} — Configurar un clon

### Reuniones y reservas
- GET /api/v1/meetings — Listar reuniones grabadas
- GET /api/v1/meetings/{id}/transcript — Leer transcripción de reunión
- GET /api/v1/bookings — Listar reservas

### Webinars
- GET /api/v1/webinars — Listar webinars
- POST /api/v1/webinars — webinars_create
- GET /api/v1/webinars/{id} — webinars_get
- PATCH /api/v1/webinars/{id} — webinars_update
- GET /api/v1/webinars/{id}/registrants — Listar inscritos de un webinar
- GET /api/v1/webinars/attendance — Exportar la asistencia a los directos de un curso

### Cuenta y consumo
- GET /api/v1/usage — Leer consumo del plan