ClonifyDevelopersAnar al tauler

Començar

  • Autenticació
  • Errors
  • Paginació
  • Límits de peticions
  • Webhooks
  • Per a agents d'IA
  • Servidor MCP

Referència de l'API

  • Avisos a eines externes3
  • Seguiment d'alumnes7
  • Lliuraments externs per API6
  • Xat amb el clon1
  • Contactes i etiquetes5
  • Accessos d'acadèmies4
  • Converses4
  • Catàleg de productes13
  • Vendes externes2
  • Coneixement12
  • Multimèdia4
  • Clons (versions a l'API)3
  • Reunions i reserves3
  • Webinars6
  • Compte i consum1
Clonify

Avisos a eines externes

GET/api/v1/webhook

Consultar avisos

Retorna webhook o null, amb destinació, pausa global, categories i últim resultat de lliurament. No inclou la clau de signatura. Comparteix la configuració del tauler.

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 modifica l’única destinació compartida del compte. Per crear-la cal url. Els camps omesos es conserven; una connexió nova comença pausada i amb totes les categories apagades. Indica active=true i les categories que vols enviar. Canviar la URL també redirigeix els avisos pendents, sense reactivar una connexió pausada. Activar categories no envia l’històric. La pausa global conserva pendents; apagar i reactivar una categoria financera descarta els seus pendents anteriors. Desar no prova el receptor ni canvia cobraments, correus o accessos. Rebutja camps desconeguts, null i tipus incorrectes. Retorna la mateixa estructura que GET; 404 sense destinació ni url.

Permís d'escriptura

Cos (JSON)

urlstring

URL HTTPS pública, fins a 500 caràcters. Obligatòria només en crear.

activeboolean

Enviar o pausar tots els avisos. Per defecte false en crear.

send_leadsboolean

Contactes nous captats pel clon.

send_conversationsboolean

Converses acabades, amb els missatges.

send_purchasesboolean

Compres registrades; no les tornis a comptar com un cobrament.

send_paymentsboolean

Cobraments confirmats de Stripe, incloses quotes.

send_payment_failuresboolean

Intents fallits de cobrament de quotes a Stripe.

send_refundsboolean

Canvis d’estat de devolucions de Stripe.

send_cancellationsboolean

Cancel·lacions de Stripe: efectiva, programada o programació revertida.

send_contact_email_changesboolean

Correccions de correu fetes des de Contactes o per un agent. Esdeveniment contact.email_changed, apagat per defecte.

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

Obtenir la clau de signatura

Retorna la clau privada existent sense canviar-la. Requereix permís write; mai no s’inclou en GET ni en les respostes de configuració. Desa-la només al servidor autoritzat que verifica les signatures; no la publiquis. Retorna 404 si no hi ha destinació.

Permís d'escriptura
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"
}