Primeros Pasos con la API de Mensajería de Zavu

Zavu proporciona una API unificada que te permite enviar mensajes a través de múltiples canales—SMS, WhatsApp y Email—con una sola integración. En esta guía, te mostraremos la configuración básica y como enviar tu primer mensaje.

Requisitos Previos

Antes de comenzar, asegurate de tener:

• Una cuenta de Zavu con credenciales de API
• Node.js 18+ o Bun instalado
• Conocimientos básicos de JavaScript/TypeScript

Instalacion

Instala el SDK de Zavu usando tu gestor de paquetes preferido:

bash
npm install @zavudev/sdk

O con bun:

bash
bun add @zavudev/sdk

Inicializar el Cliente

Crea un nuevo archivo e inicializa el cliente de Zavu con tu clave API:

typescript
import Zavudev from '@zavudev/sdk';

const client = new Zavudev({
  apiKey: process.env.ZAVUDEV_API_KEY,
});

Enviando tu Primer Mensaje

Ahora enviemos un mensaje SMS simple:

typescript
async function sendWelcomeMessage() {
  try {
    const response = await client.messages.send({
      to: '+1234567890',
      text: 'Bienvenido a Zavu!',
      channel: 'sms',
    });

    console.log('ID del Mensaje:', response.message.id);
    console.log('Estado:', response.message.status);
    console.log('Canal:', response.message.channel);
  } catch (error) {
    console.error('Error al enviar mensaje:', error);
  }
}

sendWelcomeMessage();

Enviando Mensajes de WhatsApp

Envia mensajes via WhatsApp (dentro de la ventana de conversación de 24h):

typescript
const response = await client.messages.send({
  to: '+1234567890',
  text: 'Tu pedido ha sido enviado!',
  channel: 'whatsapp',
});

console.log('Mensaje de WhatsApp enviado:', response.message.id);

Agregando Metadatos

Rastrea mensajes con metadatos personalizados:

typescript
const response = await client.messages.send({
  to: '+1234567890',
  text: 'Tu código de verificación es 123456',
  channel: 'sms',
  metadata: {
    orderId: 'ORD-12345',
    userId: 'user_abc',
  },
});

Recuperando un Mensaje

Obtiene detalles sobre un mensaje enviado:

typescript
const response = await client.messages.retrieve('message_id_here');

console.log('Detalles del mensaje:', {
  id: response.message.id,
  to: response.message.to,
  status: response.message.status,
  channel: response.message.channel,
  createdAt: response.message.createdAt,
});

Listando Mensajes

Lista mensajes con filtrado y páginacion:

typescript
// Obtener una página de mensajes
const page = await client.messages.list({
  limit: 10,
  channel: 'sms',
  status: 'delivered',
});

console.log('Mensajes:', page.items);

// Verificar si hay más páginas
if (page.hasNextPage()) {
  const nextPage = await page.getNextPage();
  console.log('Siguiente página:', nextPage.items);
}

Iteración Asincrona

Itera a través de todos los mensajes usando iteradores asincronos:

typescript
for await (const message of client.messages.list({ limit: 5 })) {
  console.log('Mensaje:', message.id, message.status);
}

Manejo de Errores

Maneja errores de la API de forma elegante:

typescript
import Zavudev from '@zavudev/sdk';

try {
  const response = await client.messages.send({
    to: '+1234567890',
    text: 'Hola!',
  });
} catch (error) {
  if (error instanceof Zavudev.APIError) {
    console.error('Error de API:', error.status, error.message);
  } else {
    throw error;
  }
}

Siguientes Pasos

Ahora que has enviado tu primer mensaje, explora estos recursos:

• Referencia de API: Documentación completa de la API
• Templates: Crea plantillas reútilizables de WhatsApp
• Broadcasts: Envia mensajes a múltiples destinatarios
• Contactos: Administra tu base de datos de contactos

Consulta nuestra documentación para más ejemplos.Necesitas ayuda para comenzar? Contáctaños o unete a nuestra comúnidad de Discord para soporte y actualizaciones.