Quickstart SDK

Qué vas a lograr: un Thread + Message inbound en sandbox con el SDK TypeScript.

Instalar

npm i @tsuzuro/sdk

Credenciales

Configura sin hardcodear:

export TSUZURO_API_KEY="tsu_test_..."
export TSUZURO_BASE_URL="https://api.tsuzuro.com"

Primer mensaje sandbox

import { TsuzuroClient } from "@tsuzuro/sdk";

const tsu = new TsuzuroClient({
  apiKey: process.env.TSUZURO_API_KEY!,
  baseUrl: process.env.TSUZURO_BASE_URL
});

const projectId = "prj_...";
const environmentId = "env_...";

const [channel] = await tsu.channels.list({
  projectId,
  environmentId,
  kind: "sandbox"
});

const sandbox =
  channel ??
  (await tsu.channels.create({
    projectId,
    environmentId,
    name: "Sandbox",
    kind: "sandbox"
  }));

const thread = await tsu.threads.create({
  projectId,
  environmentId,
  channelId: sandbox.channelId
});

const message = await tsu.threads.createMessage(thread.threadId, {
  projectId,
  direction: "inbound",
  body: "hola sandbox"
});

console.log({ threadId: thread.threadId, messageId: message.messageId });

El SDK añade Idempotency-Key automáticamente en writes críticos si no pasas uno.

Qué sigue

• Sandbox — flujo de onboarding completo.
• Quickstart CLI — mismo happy path desde la terminal.
• Conceptos: Threads — modelo de conversación.