Documentación de Klyra

Bienvenido a la documentación oficial de Klyra, la IA de recepción y ventas automatizadas de Klyent. Aquí encontrarás todo lo necesario para integrar, configurar y optimizar Klyra en tu negocio.

Quick Start

Integra Klyra en tu negocio en menos de 10 minutos siguiendo estos pasos:

Tu primera llamada a la API

Envía tu primer mensaje con Klyra usando curl:

curl -X POST https://api.klyent.com/v2/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5491112345678",
    "channel": "whatsapp",
    "message": "¡Hola! ¿En qué puedo ayudarte hoy?"
  }'

Respuesta exitosa:

{
  "id": "msg_8x7k2hj4n9",
  "status": "sent",
  "channel": "whatsapp",
  "created_at": "2026-03-13T08:30:00Z"
}

Autenticación

Todas las solicitudes a la API de Klyra requieren autenticación mediante un header Authorization con tu API Key.

Authorization: Bearer kly_live_sk_xxxxxxxxxxxxxxxxxxxx

Existen dos tipos de claves:

Integración con WhatsApp Business

Klyra se conecta directamente con la API de WhatsApp Business para atender a tus clientes desde tu número verificado.

Requisitos previos

• Cuenta de WhatsApp Business verificada
• Número de teléfono registrado en WhatsApp Business API
• Acceso al panel de Meta Business Suite
• Plan Klyent activo (Starter, Pro o Enterprise)

Configuración paso a paso

1. Accede a Panel → Canales → WhatsApp
2. Haz clic en "Conectar WhatsApp"
3. Sigue el flujo de autorización de Meta Business
4. Selecciona el número de teléfono que deseas vincular
5. Configura el mensaje de bienvenida y las respuestas automáticas

Enviar mensaje por WhatsApp

Widget Web

Instala el chat widget de Klyra en tu sitio web para que los visitantes puedan chatear con la IA directamente.

Instalación

Agrega el siguiente script antes del cierre de </body> en tu sitio:

<!-- Klyra Chat Widget -->
<script src="https://cdn.klyent.com/widget/v2/klyra.js"></script>
<script>
  KlyraWidget.init({
    apiKey: 'kly_live_pk_xxxxxxxxxxxx',
    position: 'bottom-right',
    theme: 'dark',
    greeting: '¡Hola! 👋 ¿En qué puedo ayudarte?',
    language: 'es'
  });
</script>

Opciones de configuración

Entrenamiento de la IA

Klyra aprende sobre tu negocio para dar respuestas personalizadas a tus clientes. Puedes entrenarla de las siguientes formas:

Fuentes de conocimiento

Subir documentos via API

curl -X POST https://api.klyent.com/v2/knowledge/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@catalogo.pdf" \
  -F "type=catalog" \
  -F "name=Catálogo de Productos 2026"

API — Mensajes

Endpoints para enviar, recibir y gestionar mensajes a través de Klyra.

Enviar mensaje

Listar mensajes

Obtener mensaje

API — Conversaciones

Gestiona las conversaciones entre Klyra y tus clientes.

Listar conversaciones

{
  "data": [
    {
      "id": "conv_a1b2c3d4",
      "contact": {
        "name": "María García",
        "phone": "+5491112345678"
      },
      "channel": "whatsapp",
      "status": "active",
      "ai_confidence": 0.94,
      "messages_count": 12,
      "created_at": "2026-03-13T08:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156
  }
}

Transferir a humano

Transfiere una conversación activa de la IA a un agente humano cuando la situación lo requiera.

API — Contactos

Listar contactos

Crear contacto

Actualizar contacto

Eliminar contacto

Webhooks

Recibe notificaciones en tiempo real cuando ocurren eventos en Klyra. Configura una URL de webhook para recibir payloads POST automáticamente.

Eventos disponibles

Ejemplo de payload

{
  "event": "message.received",
  "timestamp": "2026-03-13T08:30:00Z",
  "data": {
    "message_id": "msg_8x7k2hj4n9",
    "conversation_id": "conv_a1b2c3d4",
    "from": "+5491112345678",
    "content": "¿Cuánto cuesta el plan Pro?",
    "channel": "whatsapp"
  }
}

SDK — JavaScript / Node.js

Instala el SDK oficial para Node.js:

npm install @klyent/sdk

import { Klyent } from '@klyent/sdk';

const klyent = new Klyent('kly_live_sk_xxxxxxxxxxxx');

// Enviar un mensaje
const message = await klyent.messages.send({
  to: '+5491112345678',
  channel: 'whatsapp',
  content: '¡Hola! ¿En qué puedo ayudarte?'
});

// Listar conversaciones activas
const conversations = await klyent.conversations.list({
  status: 'active',
  limit: 10
});

console.log(conversations.data);

SDK — Python

pip install klyent

from klyent import Klyent

client = Klyent(api_key="kly_live_sk_xxxxxxxxxxxx")

# Enviar mensaje por WhatsApp
message = client.messages.send(
    to="+5491112345678",
    channel="whatsapp",
    content="¡Hola! ¿En qué puedo ayudarte?"
)

# Listar todas las conversaciones
conversations = client.conversations.list(status="active")
for conv in conversations.data:
    print(f"{conv.contact.name}: {conv.messages_count} mensajes")

Códigos de Error

La API de Klyra utiliza códigos HTTP estándar para indicar el resultado de cada solicitud.

Límites y Cuotas

Changelog

v2.1.0 — Marzo 2026

• Integración nativa con WhatsApp Business API
• Nuevo widget web con soporte de temas oscuros
• Webhooks para eventos de ventas completadas
• SDK de Python v1.0 lanzado

v2.0.0 — Enero 2026

• API v2 con nueva estructura de endpoints
• Motor de IA mejorado con mayor comprensión contextual
• Sistema de entrenamiento de documentos rediseñado
• Dashboard de analytics en tiempo real

v1.0.0 — Octubre 2025

• Lanzamiento inicial de Klyra
• Soporte básico de chat via widget web
• API v1 con endpoints de mensajes y conversaciones