Clonify para desarrolladores
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.
https://www.clonify.com/api/v1Para 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.
curl "https://www.clonify.com/api/v1/conversations?limit=5" \
-H "Authorization: Bearer clk_live_…"Para integrar un chat, elige Solo conversar (chat). Solo autoriza POST /api/v1/chat y consume las respuestas del plan. Los permisos de gestión son independientes: lectura permite exportar datos, incluido el conocimiento; escritura incluye lectura y también permite conversar; borrado incluye los permisos de gestión anteriores. Sin el permiso necesario se devuelve 403 insufficient_scope.
Todos los errores comparten la misma forma JSON, con un código estable en 'type' (para tu código) y un mensaje legible en 'message' (para humanos). Códigos de estado: 400 petición inválida, 401 llave ausente o revocada, 403 sin permiso / función fuera de tu plan / cuota agotada, 404 no existe en tu cuenta, 409 conflicto (p. ej. transcripción aún no lista), 429 límite de peticiones, 500 error nuestro.
{
"error": {
"type": "invalid_updated_since",
"message": "'updated_since' no es una fecha válida (usa ISO 8601)."
}
}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.
{
"object": "list",
"data": [ … ],
"has_more": true,
"next_starting_after": 95
}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.
Ojo: esto es distinto de las cuotas del plan (respuestas del clon, palabras del conocimiento). Esas se consultan en GET /api/v1/usage y se aplican igual que en el panel.
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.
Si tu integración la escribe una IA (ChatGPT, Claude…), tiene dos accesos directos pensados para máquinas, no para leer a ojo. Y si prefieres no programar nada: Clonify también expone un servidor MCP con más de 100 herramientas. Conéctalo desde Configuración → Conecta tu IA.