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

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

Converses

GET/api/v1/conversations

Llistar converses

Les converses reals del teu clon, amb els missatges complets. Les proves que fas des del tauler amb "Prova el teu clon" no surten mai per aquí ni pels webhooks. Pensat per a sincronització incremental: demana només el nou amb updated_since.

Paràmetres de consulta

limitinteger 1..100
starting_afterinteger

Cursor: retorna converses amb id més gran que aquest.

updated_sinceISO 8601

Només converses amb activitat des d'aquesta data (una d'antiga amb missatge nou hi entra).

visitor_emailstring

Només les d'aquest visitant identificat (l'historial d'una persona).

channel_idinteger

Només les d'aquesta superfície (web, WhatsApp, Instagram…).

review_statusstring

pending = només les que ningú no ha repassat encara; reviewed = només les ja repassades.Valors: pending · reviewed

bash
curl "https://www.clonify.com/api/v1/conversations" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "object": "list",
  "data": [{
    "object": "conversation",
    "id": 90,
    "visitor": { "email": "ana@example.com", "name": "Ana Pérez" },
    "channel_id": 15,
    "title": null,
    "first_page_url": null,
    "review_status": "pending",
    "message_count": 4,
    "started_at": "2026-05-15T09:36:48.918Z",
    "last_message_at": "2026-05-15T09:37:16.909Z",
    "messages": [
      { "role": "user", "content": "hola, ¿me ayudas?", "created_at": "…" },
      { "role": "assistant", "content": "¡Claro! Cuéntame…", "created_at": "…" }
    ]
  }],
  "has_more": true,
  "next_starting_after": 95
}
GET/api/v1/conversations/{id}

Llegir una conversa

Una conversa amb els seus missatges, per id.

Paràmetres de ruta

idintegerobligatori
bash
curl "https://www.clonify.com/api/v1/conversations/1" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/conversations/reviewed

Marcar converses com a revisades

Deixa constància de quines converses ja has processat, per no tornar-les a tenir en compte. És la parella de review_status=pending en llistar: demana el que hi ha pendent, tracta-ho i marca-ho. Un id que no existeix no fa caure el lot: apareix a not_found.

Permís d'escriptura

Cos (JSON)

conversation_idsinteger[] (1..100)obligatori

Ids a marcar, d'1 a 100 per petició.

reviewedboolean

true (per defecte) marca com a revisades; false les torna a pendents.

bash
curl -X POST "https://www.clonify.com/api/v1/conversations/reviewed" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"conversation_ids":1}'
json
{
  "object": "conversations_reviewed",
  "review_status": "reviewed",
  "updated": [90, 91],
  "unchanged": [88],
  "not_found": [4001]
}
DELETE/api/v1/visitors/{anon_id}

Esborrar un visitant i tot el seu historial

Esborra el visitant SENCER pel seu identificador anònim: la seva fitxa de visitant i, en cascada, les seves converses, missatges, valoracions, progrés de cursos, adjunts i els casos d'escalació que va obrir (els avisos que van arribar a la teva safata, amb la transcripció). És el dret de supressió d'un usuari final executat des del teu sistema, pensat per al clon incrustat amb identitat anònima pròpia (l'aid que passes al tauler). Retorna un acusament amb allò esborrat i l'hora d'execució. Idempotent: un segon esborrat del mateix anon_id respon 404 not_found. No confondre amb DELETE /contacts/{id}, que esborra la fitxa de CRM i conserva les converses.

Permís d'esborrat

Paràmetres de ruta

anon_idstringobligatori

Identificador anònim del visitant: l'aid que passes al tauler incrustat o el que va generar el widget. Únic per compte. Entre 8 i 128 caràcters (lletres, números, punt, guió, guió baix, dos punts o arroba).

bash
curl -X DELETE "https://www.clonify.com/api/v1/visitors/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
json
{
  "object": "visitor_erasure",
  "anon_id": "3f9c0a1b2c3d4e5f6a7b8c9d0e1f2a3b",
  "visitor_id": 8123,
  "deleted": true,
  "conversations_deleted": 3,
  "messages_deleted": 41,
  "support_cases_deleted": 1,
  "erased_at": "2026-09-09T15:02:11.000Z"
}