ClonifyDevelopersIr al panel

Empezar

  • Autenticación
  • Errores
  • Paginación
  • Límites de peticiones
  • Webhooks
  • Para agentes de IA
  • Servidor MCP

Referencia de la API

  • Seguimiento de alumnos6
  • Entregas externas por API6
  • Chat con el clon1
  • Contactos y etiquetas5
  • Accesos de academias4
  • Conversaciones4
  • Catálogo de productos11
  • Ventas externas2
  • Conocimiento12
  • Multimedia4
  • Clones (versions en la API)3
  • Reuniones y reservas3
  • Webinars6
  • Cuenta y consumo1
Clonify

Entregas externas por API

GET/api/v1/external-delivery/connections

Conexiones de entrega externa

Lista conexiones autorizadas y estado de credenciales, sin devolver secretos. Páginas de hasta 100 registros.

Parámetros de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/connections" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/connections

Guardar conexión de entrega externa

POST JSON a una URL HTTPS pública sin parámetros, fragmentos ni credenciales. name (2–120), url (hasta 500), auth (none o bearer), enabled (true por defecto). Sin id crea otra conexión. Con id actualiza nombre, enabled y token, conservando URL, auth y contrato de éxito. token (12–4096) es de solo escritura: omitirlo conserva el actual. Para bearer autorízalo por esta API, nunca dentro del chat. successField y successValue deben indicarse juntos; si faltan, cualquier HTTP 2xx confirma. La API de destino debe soportar reintentos con Idempotency-Key; idempotencySupported debe ser true. No se envía ninguna prueba ni se concede acceso al guardar. Deshabilitar la conexión detiene sus envíos pendientes.

Permiso de escritura

Cuerpo (JSON)

idinteger
namestringobligatorio
urlstringobligatorio
authstringobligatorio

Valores: none · bearer

tokenstring
enabledboolean
successFieldstring
successValuestring | number | boolean | null
idempotencySupportedbooleanobligatorio
bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/connections" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","url":"…","auth":"none","idempotencySupported":true}'
json
{
  "data": {
    "id": 7,
    "name": "External access",
    "url": "https://service.example/api/access",
    "auth": "bearer",
    "enabled": true,
    "has_credential": true,
    "success_field": "ok",
    "success_value": true
  }
}
GET/api/v1/external-delivery/rules

Reglas de entrega externa

Lista las asociaciones entre productos y conexiones, sus campos y activación. Páginas de hasta 100 registros.

Parámetros de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/rules" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/rules

Guardar regla de entrega externa

Asocia el producto exacto vendido (el pack, no sus componentes) a una conexión. payload contiene entre 1 y 32 campos JSON planos: cada valor lleva source (buyer.email, buyer.name, purchase.id o product.id) o value (constante de texto, número, booleano o null). Sin id crea o sustituye la regla de ese producto y conexión. Con id solo puede actualizar esa misma asociación. enabled es false por defecto y requiere una conexión habilitada y autorizada. Solo compras futuras registradas; incluye compras externas importadas. No incluye compradores antiguos, etiquetas ni accesos manuales. Cambiar o desactivar una regla no altera entregas ya en cola. refundPolicy es review por defecto: cualquier devolución cancela pendientes y deja entregas enviadas o en curso para revisión manual; keep conserva la entrega. No hay revocación automática.

Permiso de escritura

Cuerpo (JSON)

idinteger
productIdintegerobligatorio
connectionIdintegerobligatorio
payloadobjectobligatorio
enabledboolean
refundPolicystring

Valores: review · keep

bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/rules" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"productId":1,"connectionId":1,"payload":[{"…":"…"}]}'
GET/api/v1/external-delivery/deliveries

Estado de entregas externas

Lista compras y estado: pending, delivering, delivered, failed, review o cancelled. delivered significa confirmación según el contrato de la API; no confirma inicio de sesión del comprador. Hasta ocho intentos automáticos ante fallos temporales, con la misma Idempotency-Key. Páginas de hasta 100 registros.

Parámetros de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/deliveries" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/deliveries/{id}/retry

Reintentar entrega externa

Pone una entrega failed en pending, conservando su clave idempotente. Requiere conexión habilitada y ninguna devolución pendiente de revisión. No ejecuta el acceso durante esta petición.

Permiso de escritura

Parámetros de ruta

idintegerobligatorio
bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/deliveries/1/retry" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'