Nexar SDK

Official TypeScript SDK for Nexar services.

Currently supports:

• WhatsApp messaging
• Template messages
• Interactive messages with buttons

Installation

npm install nexar-sdk

Quick Start

import { Nexar } from "nexar-sdk";

const nexar = Nexar.init({
  token: "your-auth-token",
  businessId: 123
});

await nexar.whatsapp.sendQuickText(
  "57300XXXXXXX",
  "Hello from Nexar 🚀"
);

Configuration

const nexar = Nexar.init({
  token: "your-auth-token",
  businessId: 123,
  // Optional:
  // baseUrl: "https://staging.nexar.com.co"
});

Options

| Option | Type | Required | Description | | ---------- | --------------- | -------- | ------------------------ | | token | string | Yes | API authentication token | | businessId | string | Yes | Your Nexar business ID | | baseUrl | string | No | Custom API URL |

Default API URL:

https://back.nexar.com.co

WhatsApp API

Send Text Message

await nexar.whatsapp.sendText({
  celular: "57300XXXXXXX",
  body: "Hello!"
});

Quick Text

await nexar.whatsapp.sendQuickText(
  "57300XXXXXXX",
  "Quick message"
);

Send Template

await nexar.whatsapp.sendTemplate({
  templateName: "welcome_template",
  templateLanguage: "en_US",
  contacts: [
    {
      telefono: "57300XXXXXXX",
      variables: {
        name: "John"
      }
    }
  ]
});

Send Interactive Message

await nexar.whatsapp.sendInteractive({
  celular: "57300XXXXXXX",
  body: "Choose an option",
  buttonText: "Options",
  buttons: [
    { id: "1", title: "Option 1" },
    { id: "2", title: "Option 2" }
  ]
});

Response Format

All methods return:

interface ApiResponse<T = unknown> {
  code: number;
  msg: string;
  data?: T;
  errorDetail?: unknown;
  pagination?: {
    page: number;
    pageSize: number;
    total: number;
  };
}

Runtime Support

• Node.js 18+
• Bun
• Deno
• Edge runtimes
• Browsers (if CORS enabled)

IA WABA File API

The IA WABA module allows you to upload, update, expire, or delete indexed documents.

Endpoint:

POST /iawaba/api-receptor/{businessId}

Upload or Update File

If the file exists, it is fully replaced. If it does not exist, it is created.

The SDK automatically generates the checksum internally. You only provide the content.

await nexar.iawaba.uploadFile({
  folder: "auto", // "general" | "auto" | "prompt"
  name: "manual-producto.md",
  content: `# Product Manual

## Features
- High quality
- 2 year warranty`,
  vencido: 0,
  ven: Date.now() + 30 * 24 * 60 * 60 * 1000 // 30 days
});

Delete File (Soft Delete)

Marks the file as expired. It becomes inaccessible immediately.

await nexar.iawaba.deleteFile(
  "auto",
  "manual-producto.md"
);

Expiration Examples

// 7 days
Date.now() + 7 * 24 * 60 * 60 * 1000

// 1 month (approx)
Date.now() + 30 * 24 * 60 * 60 * 1000

// No expiration
ven: null

Automatic Cleanup System

• Daily cron job runs automatically
• Files past expiration are removed from storage
• Vector database is re-indexed automatically
• Deleted files become inaccessible immediately

Documentation

For complete API reference, advanced configuration, and platform-specific details, visit:

👉 https://nexar.com.co/api/docs/waba

This SDK covers the most common operations. The full REST API documentation includes:

• Raw endpoint specifications
• Authentication details
• Advanced configuration
• Webhook information
• Error reference

License

MIT