Guía rápida | Lectico Docs

Requisitos

Una cuenta en app.lectico.com.
Una API key de tipo admin (ver autenticación). Recomendamos empezar con una sk_test_*.
Node.js 18+ si vas a usar el SDK (opcional).

1. Guarda la clave

Define la clave como variable de entorno para no pegarla en el código:

export LECTICO_API_KEY=sk_test_xxxxxxxx

2. Crea un asistente

Con curl:

curl -X POST https://api.lectico.com/v1/agents \
  -H "Authorization: Bearer $LECTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "support",
    "name": "Soporte Demo"
  }'

Respuesta:

{
  "data": {
    "id": "agt_01HZ...",
    "type": "support",
    "name": "Soporte Demo",
    "slug": "soporte-demo",
    "created_at": "2026-04-13T14:12:00Z"
  },
  "meta": { "request_id": "req_..." }
}

3. Envía un mensaje

El endpoint /v1/agents/{id}/messages devuelve streaming por defecto. Para recibir JSON plano, pasa stream: false:

curl -X POST https://api.lectico.com/v1/agents/agt_01HZ.../messages \
  -H "Authorization: Bearer $LECTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hola, que puedes hacer?",
    "stream": false
  }'

4. Lo mismo con el SDK de Node

import Lectico from "@lectico/api";

const lectico = new Lectico({ apiKey: process.env.LECTICO_API_KEY! });

const agent = await lectico.agents.create({ type: "support", name: "Soporte Demo" });

const stream = await lectico.agents.messages.create(agent.id, {
  message: "Hola, que puedes hacer?",
});

for await (const ev of stream as AsyncIterable<any>) {
  if (ev.type === "token") process.stdout.write(ev.content ?? "");
}

Siguientes pasos

Añade conocimiento al asistente para que responda con tu contenido.
Configura webhooks para recibir eventos en tiempo real.
Revisa los conceptos clave (paginación, errores, idempotencia) antes de ir a producción.