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

Conversaciones

GET/api/v1/conversations

Listar conversaciones

Las conversaciones reales de tu clon, con los mensajes completos. Las pruebas que haces desde el panel con "Prueba tu clon" no salen nunca por aquí ni por los webhooks. Pensado para sincronización incremental: pide solo lo nuevo con updated_since.

Parámetros de consulta

limitinteger 1..100
starting_afterinteger

Cursor: devuelve conversaciones con id mayor que este.

updated_sinceISO 8601

Solo conversaciones con actividad desde esa fecha (una vieja con mensaje nuevo entra).

visitor_emailstring

Solo las de ese visitante identificado (el histórico de una persona).

channel_idinteger

Solo las de esa superficie (web, WhatsApp, Instagram…).

review_statusstring

pending = solo las que nadie ha repasado aún; reviewed = solo las ya repasadas.Valores: 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}

Leer una conversación

Una conversación con sus mensajes, por id.

Parámetros de ruta

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

Marcar conversaciones como revisadas

Deja constancia de qué conversaciones ya has procesado, para no volver a traértelas. Es la pareja de review_status=pending al listar: pide lo pendiente, trátalo y márcalo. Un id que no existe no tumba el lote: sale en not_found.

Permiso de escritura

Cuerpo (JSON)

conversation_idsinteger[] (1..100)obligatorio

Ids a marcar, de 1 a 100 por petición.

reviewedboolean

true (por defecto) marca como revisadas; false las devuelve a pendientes.

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}

Borrar un visitante y todo su historial

Borra al visitante ENTERO por su identificador anónimo: su ficha de visitante y, en cascada, sus conversaciones, mensajes, valoraciones, progreso de cursos, adjuntos y los casos de escalación que abrió (los avisos que llegaron a tu bandeja, con su transcripción). Es el derecho de supresión de un usuario final ejecutado desde tu sistema, pensado para el clon embebido con identidad anónima propia (el aid que pasas al panel). Devuelve un acuse con lo borrado y la hora de ejecución. Idempotente: un segundo borrado del mismo anon_id responde 404 not_found. No confundir con DELETE /contacts/{id}, que borra la ficha de CRM y conserva las conversaciones.

Permiso de borrado

Parámetros de ruta

anon_idstringobligatorio

Identificador anónimo del visitante: el aid que pasas al panel embebido o el que generó el widget. Único por cuenta. Entre 8 y 128 caracteres (letras, números, punto, guion, guion bajo, dos puntos 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"
}