Node.js SDK

npm install @zavu/node
# or
bun add @zavu/node
# or
yarn add @zavu/node

import { Zavu } from '@zavu/node';

const zavu = new Zavu(process.env.ZAVU_API_KEY);

// Send a message
const message = await zavu.messages.send({
  to: '+56912345678',
  text: 'Hello from Zavu!'
});

console.log('Message sent:', message.id);

import { Zavu } from '@zavu/node';

// Basic initialization
const zavu = new Zavu('zv_live_xxx');

// With options
const zavu = new Zavu('zv_live_xxx', {
  baseUrl: 'https://api.zavu.dev', // Custom API URL
  timeout: 30000,                   // Request timeout in ms
});

const zavu = new Zavu(process.env.ZAVU_API_KEY!);

const message = await zavu.messages.send({
  to: '+56912345678',
  text: 'Your verification code is 123456',
  channel: 'sms', // optional: sms, whatsapp, auto
  metadata: {     // optional: custom data
    userId: 'user_123'
  },
  idempotencyKey: 'unique-key' // optional: prevent duplicates
});

console.log(message.id);     // msg_xxx
console.log(message.status); // queued

const message = await zavu.messages.send({
  to: '+56912345678',
  templateId: 'tpl_abc123',
  data: {
    customerName: 'John',
    orderId: '12345'
  }
});

const message = await zavu.messages.get('msg_abc123');

console.log(message.status); // queued, sending, delivered, failed

// List all messages
const { items, nextCursor } = await zavu.messages.list();

// With filters
const { items } = await zavu.messages.list({
  status: 'delivered',
  channel: 'sms',
  limit: 100
});

// Pagination
let cursor: string | undefined;
do {
  const result = await zavu.messages.list({ cursor, limit: 50 });
  for (const message of result.items) {
    console.log(message.id);
  }
  cursor = result.nextCursor;
} while (cursor);

const template = await zavu.templates.create({
  name: 'order_confirmation',
  category: 'transactional',
  body: 'Hi {{name}}, your order #{{orderId}} is confirmed!'
});

const { items } = await zavu.templates.list();

const template = await zavu.templates.get('tpl_abc123');

const template = await zavu.templates.update('tpl_abc123', {
  body: 'Hi {{name}}, order #{{orderId}} confirmed! Delivery: {{date}}'
});

await zavu.templates.delete('tpl_abc123');

const { items } = await zavu.senders.list();

const sender = await zavu.senders.create({
  name: 'Marketing',
  routingPolicy: 'prefer_whatsapp',
  channels: {
    sms: { phoneNumber: '+15551234567' },
    whatsapp: { phoneNumber: '+15551234567' }
  },
  setAsDefault: true
});

const contact = await zavu.contacts.get('con_abc123');
// or by phone
const contact = await zavu.contacts.getByPhone('+56912345678');

const contact = await zavu.contacts.update('con_abc123', {
  defaultChannel: 'whatsapp',
  metadata: {
    name: 'John Doe',
    tier: 'premium'
  }
});

import { Zavu, ZavuError } from '@zavu/node';

try {
  await zavu.messages.send({
    to: 'invalid-number',
    text: 'Hello'
  });
} catch (error) {
  if (error instanceof ZavuError) {
    console.error('Code:', error.code);      // bad_request
    console.error('Message:', error.message); // Invalid phone number
    console.error('Status:', error.status);   // 400
  } else {
    throw error;
  }
}

import { Zavu, Message, Template, SendMessageRequest } from '@zavu/node';

const request: SendMessageRequest = {
  to: '+56912345678',
  text: 'Hello!'
};

const message: Message = await zavu.messages.send(request);

const { Zavu } = require('@zavu/node');

const zavu = new Zavu(process.env.ZAVU_API_KEY);