Integraciones · SDK Node.js

SDK oficial Node.js

Paquete @vaidesk/sdk-node. Tipado, con helpers para verificación de firma HMAC de webhooks y manejo estructurado de errores.

Instalación

bash

npm install @vaidesk/sdk-node

Cliente tipado

Todas las operaciones expuestas como métodos tipados. Retornos validados en runtime. Helpers para verificación de firma de webhook.

Errores estructurados

Cada error tiene type, code, message, param, doc_url. Códigos consistentes: authentication_error, permission_error, invalid_request_error, rate_limit_error, idempotency_error.

SSE alternativa

Para dashboards que prefieren pull en vez de webhook: /v1/events/stream long-lived. Last-Event-Id para retomar.

Ejemplo: cliente Node.js

typescript

import { VAiDeskClient } from '@vaidesk/sdk-node';

const client = new VAiDeskClient({
  apiKey: process.env.VAIDESK_API_KEY!,
});

const conversation = await client.conversations.create({
  externalUserId: 'user_123',
  subject: 'Question about plan',
  initiatedBySide: 'end_user',
  metadata: { plan: 'pro', signupAt: '2026-06-28' },
});

console.log(conversation.id);

¿Listo para integrar atención al cliente robusta en su producto?

Cuéntenos sobre su caso. Respondemos en un día hábil.

Hablar con ventas contact@vaidesk.com