Integrações · SDK Node.js

SDK oficial Node.js

Pacote @vaidesk/sdk-node. Tipado, com helpers para verificação de assinatura HMAC dos webhooks e tratamento estruturado de erros.

Instalação

bash

npm install @vaidesk/sdk-node

Cliente tipado

Todas as operações expostas como métodos tipados. Retornos validados em runtime. Helpers para webhook signature verification.

Erros estruturados

Cada erro tem 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 preferem pull em vez de webhook: /v1/events/stream long-lived. Last-Event-Id para retomar.

Exemplo: 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);

Pronto para integrar atendimento robusto no seu produto?

Conte sobre seu caso. Retornamos em até um dia útil.

Falar com vendas contact@vaidesk.com