Xat amb el clon

POST/api/v1/chat

Parlar amb el clon

Envia un missatge i rep la resposta completa del clon en JSON (sense streaming), amb les seves accions estructurades: producte recomanat, enllaç, vídeo, oferta de parlar amb un humà. Mateix motor que el web i WhatsApp (coneixement, FAQs, catàleg). Cada resposta compta 1 contra les respostes mensuals del teu pla, i les converses queden visibles al panell en el canal «API». També respecta el límit mensual configurat per a aquest clon (403 cap_reached) i frena repeticions automàtiques abans de generar una resposta (429 automated_repetition).

Conversa (o escriptura)

Cos (JSON)

messagestring 1..4000obligatori

El missatge de l'usuari (màx 4000 caràcters).

conversation_idinteger

Continua aquest fil (te'l va retornar una crida anterior). Si l'envies, els camps de visitant s'ignoren.

visitor_external_idstring

El TEU id estable de l'usuari final (recomanat per a sistemes). Cada usuari manté el seu fil continu.

visitor_emailstring

Identifica l'usuari pel seu email (s'uneix al mateix visitant del widget verificat, si existeix).

visitor_namestring

version_idinteger

Quin clon respon. Ometre = el clon actiu del teu clon.

new_conversationboolean

true obre un fil nou en comptes de continuar el més recent (p. ex. un tiquet diferent).

bash

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

json

{
  "object": "chat.reply",
  "conversation_id": 412,
  "visitor_id": 88,
  "reply": {
    "content": "¡Claro! Para empezar con la sentadilla te recomiendo…",
    "actions": [
      { "type": "product", "product_id": 172 },
      { "type": "link", "url": "https://example.com/guia", "label": "Ver la guía" }
    ]
  },
  "usage": { "input_tokens": 5210, "output_tokens": 240 }
}