API v2

@zavudev/sdk 0.59.0 and later calls API v2 as client.v2, on the same client, API key, retries and pagination as v1. v1 stays where it was: client.messages is v1, client.v2.messages is v2, and the two can be mixed in one codebase.

terminalCopy
npm add @zavudev/sdk@^0.59.0

TypeScriptCopy
import Zavudev from '@zavudev/sdk';

const zavu = new Zavudev(); // reads ZAVUDEV_API_KEY

const { message, routing } = await zavu.v2.messages.send({
  from: '+13125551212',
  to: '+56912345678',
  text: 'Your code is 123456.',
});

Ids are positional

Every id in a v2 path is an argument, in the order the path has it. Body and query fields go in the object after them.

TypeScriptCopy
await zavu.v2.channels.activate('+13125551212', 'whatsapp');
await zavu.v2.channels.disconnect('@acme_bot', 'telegram');
await zavu.v2.agents.channels.disconnect('agent_abc123', '+13125551212', 'sms');
await zavu.v2.templates.submit('tmpl_abc123', { from: '+13125551212' });

Pass an address as you read it from GET /v2/channels. The SDK puts it in the path for you; you do not encode the + yourself.

Types

v2's Message, Contact and Template are not v1's, so v2's types have their own entry point:

TypeScriptCopy
import type { MessageSendParams, ChannelEntry } from '@zavudev/sdk/v2';

The root of @zavudev/sdk keeps exporting v1's types, as before.

Lists

A list call pages for you. Iterate it to follow nextCursor to the end, or read one page:

TypeScriptCopy
for await (const entry of zavu.v2.channels.list()) {
  console.log(entry.address, entry.type, entry.active);
}

const page = await zavu.v2.conversations.list({ limit: 20 });

Errors

A failed call throws the same classes as v1, from the root of the package. A v2 error body is {code, message, details} at the root, and the SDK keeps it on error.error:

TypeScriptCopy
try {
  await zavu.v2.messages.send({ to: '+56912345678', text: 'Hi' });
} catch (err) {
  if (!(err instanceof Zavudev.ConflictError)) throw err;
  const body = err.error as { code?: string; details?: { connect?: unknown[] } } | undefined;
  if (body?.code !== 'no_channel') throw err;
  console.log(body.details?.connect); // the channels you could connect to send this
}

A 409 is a ConflictError and is not retried: v2 answers it with x-should-retry: false, and the SDK reads that header. See Errors.

Methods

What v2 does not cover (voice calls, 10DLC, memory, sub-accounts and the rest listed in Migrate from v1) stays on the v1 methods of the same client.