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

Contactes i etiquetes

GET/api/v1/contacts

Llistar contactes

Exporta els teus contactes amb les seves etiquetes (i la caducitat de cadascuna).

Paràmetres de consulta

limitinteger 1..200
starting_afterinteger

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

bash
curl "https://www.clonify.com/api/v1/contacts" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "object": "list",
  "data": [{
    "object": "contact",
    "id": 3,
    "email": "ana@example.com",
    "name": "Ana Pérez",
    "phone": null,
    "source": "visitor",
    "tags": [{ "name": "Alumna Curso X", "color": "blue", "expires_at": null }],
    "conversation_count": 4,
    "first_seen_at": "2026-05-01T10:00:00.000Z",
    "last_seen_at": "2026-07-01T09:30:00.000Z",
    "created_at": "2026-05-01T10:00:00.000Z",
    "updated_at": "2026-07-01T09:30:00.000Z"
  }],
  "has_more": true,
  "next_starting_after": 3
}
POST/api/v1/contacts

Crear o actualitzar un contacte

Importa un contacte des del teu sistema. Idempotent per email: si ja existeix, enriqueix els camps buits i suma les etiquetes. Per sincronitzar cursos o membresies externes usa el protocol d'Accessos; aquesta ruta queda per a CRM, segmentació i integracions anteriors.

Permís d'escriptura

Cos (JSON)

emailstringobligatori
namestring
phonestring
tagsstring[] (máx 20 × 255)

Etiquetes a afegir (màx. 20; 255 caràcters per nom). Les que no existeixin es creen.

remove_tagsstring[] (máx 20 × 255)

Etiquetes a RETIRAR en aquesta crida (màx. 20; 255 caràcters per nom).

expires_atISO 8601 | null

Data final de les etiquetes d’aquesta crida (ISO 8601). Si s’omet, conserva les dates existents i aplica la durada del producte a les noves etiquetes d’accés. null concedeix accés de per vida. Una data explícita actualitza el venciment.

bash
curl -X POST "https://www.clonify.com/api/v1/contacts" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"email":"…"}'
GET/api/v1/contacts/{id}

Llegir un contacte

Un contacte concret amb les seves etiquetes.

Paràmetres de ruta

idintegerobligatori
bash
curl "https://www.clonify.com/api/v1/contacts/1" \
  -H "Authorization: Bearer clk_live_…"
DELETE/api/v1/contacts/{id}

Esborrar un contacte

Esborra el contacte PERMANENTMENT, amb les seves notes i etiquetes. Les seves converses NO s'esborren. Pensat per sincronitzar baixes des del teu sistema (RGPD, neteja del CRM).

Permís d'esborrat

Paràmetres de ruta

idintegerobligatori
bash
curl -X DELETE "https://www.clonify.com/api/v1/contacts/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
json
{ "id": 3, "deleted": true }
GET/api/v1/tags

Llistar etiquetes

El teu catàleg d'etiquetes amb el seu significat per al clon (clon_context), el producte enllaçat i el nombre de contactes.

bash
curl "https://www.clonify.com/api/v1/tags" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "object": "list",
  "data": [{
    "object": "tag",
    "id": 24569,
    "name": "Alumna Curso X",
    "color": "blue",
    "clon_context": "Es alumna del Curso X",
    "product_id": 172,
    "contact_count": 41
  }],
  "has_more": false,
  "next_starting_after": null
}