Chat con el clon

POST/api/v1/chat

Hablar con el clon

Envía un mensaje y recibe la respuesta completa del clon en JSON (sin streaming), con sus acciones estructuradas: producto recomendado, enlace, vídeo, oferta de hablar con un humano. Mismo motor que la web y WhatsApp (conocimiento, FAQs, catálogo). Cada respuesta cuenta 1 contra las respuestas mensuales de tu plan, y las conversaciones quedan visibles en el panel en el canal «API». También respeta el límite mensual que configures para ese clon (403 cap_reached) y frena repeticiones automáticas antes de generar una respuesta (429 automated_repetition).

Conversación (o escritura)

Cuerpo (JSON)

messagestring 1..4000obligatorio

El mensaje del usuario (máx 4000 caracteres).

conversation_idinteger

Continúa ese hilo (te lo devolvió una llamada anterior). Si lo envías, los campos de visitante se ignoran.

visitor_external_idstring

TU id estable del usuario final (recomendado para sistemas). Cada usuario mantiene su hilo continuo.

visitor_emailstring

Identifica al usuario por su email (se une al mismo visitante del widget verificado, si existe).

visitor_namestring

version_idinteger

Qué clon responde. Omitir = el clon activo.

new_conversationboolean

true abre un hilo nuevo en vez de continuar el más reciente (p. ej. un ticket distinto).

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 }
}