Clonify per a desenvolupadors
Connecta el teu sistema (el teu CRM, la teva app, Make…) amb el teu compte de Clonify: llegeix les teves converses, contactes i transcripcions, i construeix des de fora. Afegeix contingut al teu Coneixement i crea productes, preguntes freqüents i clons. L'API parla JSON sobre HTTPS i utilitza les mateixes regles que el panell: les teves quotes i candaus de pla es respecten sols.
https://www.clonify.com/api/v1Per connectar un xat tria Només conversar. Crea la teva clau al tauler: Compte → Ús → Connexions → Claus d'API. Pots tenir-ne diverses (una per sistema connectat), cadascuna amb permisos de només lectura, de lectura i escriptura, o totals (amb eliminació). La clau es mostra UNA sola vegada: desa-la com una contrasenya. Envia-la a cada petició a la capçalera Authorization.
curl "https://www.clonify.com/api/v1/conversations?limit=5" \
-H "Authorization: Bearer clk_live_…"Per integrar un xat, tria Només conversar (chat). Només autoritza POST /api/v1/chat i consumeix les respostes del pla. Els permisos de gestió són independents: lectura permet exportar dades, inclòs el coneixement; escriptura inclou lectura i també permet conversar; esborrat inclou els permisos de gestió anteriors. Sense el permís necessari es retorna 403 insufficient_scope.
Tots els errors comparteixen la mateixa forma JSON, amb un codi estable a 'type' (per al teu codi) i un missatge llegible a 'message' (per a humans). Codis d'estat: 400 petició invàlida, 401 clau absent o revocada, 403 sense permís / funció fora del teu pla / quota esgotada, 404 no existeix al teu compte, 409 conflicte (p. ex. transcripció encara no llesta), 429 límit de peticions, 500 error nostre.
{
"error": {
"type": "invalid_updated_since",
"message": "'updated_since' no es una fecha válida (usa ISO 8601)."
}
}Els llistats grans es recorren per cursor: demana amb ?limit= i encadena ?starting_after=<último id> mentre has_more sigui true. El cursor és estable per id: pots recórrer tot l'historial sense perdre ni duplicar elements. Els catàlegs delimitats (etiquetes, clons, productes) arriben sencers en una resposta.
{
"object": "list",
"data": [ … ],
"has_more": true,
"next_starting_after": 95
}Cada compte té un quota de peticions per minut segons el seu pla: 60 (Starter), 120 (Pro) o 300 (Scale), compartida entre totes les seves claus. Cada resposta inclou les capçaleres X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. En superar-lo reps 429 amb Retry-After (espera i torna a intentar amb backoff). El límit talla scripts descontrolats, no ús real: a 120/min s'exporten 12.000 converses per minut.
Ull: això és diferent de les quotes del pla (respostes del clon, paraules del coneixement). Aquestes es consulten a GET /api/v1/usage i s'apliquen igual que al tauler.
A més de llegir sota demanda, Clonify pot avisar-te en temps real: configura la teva URL a Configuració → Claus d'API i webhooks i rebràs lead.created (nou contacte captat pel clon), conversation.ended (conversa real acabada després de 10 minuts sense missatges, amb els seus missatges; les proves del tauler no s'envien) i purchase.created (cada compra registrada, amb el correu de qui compra, el producte i l'import). Cada avís s'activa per separat. Cada enviament va signat amb HMAC-SHA256 a la capçalera de signatura usant el teu secret whsec_…. Verifica la signatura abans de processar.
Si la teva integració la escriu una IA (ChatGPT, Claude…), té dues dreceres pensades per a màquines, no per llegir a ull. I si prefereixes no programar res: Clonify també exposa un servidor MCP amb més de 100 eines. Connecta'l des de Compte → Ús → Connexions → Connector d'IA.