ClonifyDevelopersIr al panel

Empezar

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

Referencia de la API

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

Avisos a herramientas externas

GET/api/v1/webhook

Consultar avisos

Devuelve webhook o null, con destino, pausa global, categorías y último resultado de entrega. No incluye la clave de firma. Es la misma configuración que el panel.

bash
curl "https://www.clonify.com/api/v1/webhook" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "webhook": {
    "url": "https://receiver.example/events",
    "active": false,
    "send_leads": false,
    "send_conversations": false,
    "send_purchases": false,
    "send_payments": true,
    "send_payment_failures": false,
    "send_refunds": false,
    "send_cancellations": false,
    "send_contact_email_changes": false,
    "last_success_at": null,
    "last_error": null,
    "consecutive_failures": 0
  }
}
PUT/api/v1/webhook

Configurar avisos

Crea o cambia el único destino compartido de la cuenta. Se necesita url al crear. Lo omitido se conserva; una conexión nueva empieza pausada y con todas las categorías apagadas. Indica active=true y las categorías que quieras enviar. Cambiar la URL redirige también los avisos pendientes, sin reactivar una conexión pausada. Activar categorías no envía histórico. La pausa global conserva pendientes; apagar y reactivar una categoría financiera descarta sus pendientes anteriores. Guardar no prueba el receptor ni cambia cobros, correos o accesos. Rechaza campos desconocidos, null y tipos incorrectos. Devuelve la misma estructura que GET; 404 sin destino ni url.

Permiso de escritura

Cuerpo (JSON)

urlstring

URL HTTPS pública, hasta 500 caracteres. Obligatoria solo al crear.

activeboolean

Enviar o pausar todos los avisos. Por defecto false al crear.

send_leadsboolean

Contactos nuevos captados por el clon.

send_conversationsboolean

Conversaciones terminadas, con su hilo.

send_purchasesboolean

Compras registradas; no sumarlas otra vez como un cobro.

send_paymentsboolean

Cobros confirmados de Stripe, incluidas cuotas.

send_payment_failuresboolean

Intentos fallidos de cobro de cuotas en Stripe.

send_refundsboolean

Cambios de estado de devoluciones de Stripe.

send_cancellationsboolean

Cancelaciones de Stripe: efectiva, programada o programación revertida.

send_contact_email_changesboolean

Correcciones de correo realizadas desde Contactos o por un agente. Evento contact.email_changed, apagado por defecto.

bash
curl -X PUT "https://www.clonify.com/api/v1/webhook" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"…","active":true}'
POST/api/v1/webhook/secret

Obtener clave de firma

Devuelve la clave privada existente, sin cambiarla. Requiere permiso write y nunca se incluye en GET ni al configurar. Guárdala únicamente en el servidor autorizado que verifica las firmas; no la publiques. Devuelve 404 si no hay destino.

Permiso de escritura
bash
curl -X POST "https://www.clonify.com/api/v1/webhook/secret" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
json
{
  "secret": "whsec_REDACTED"
}