@devotel/devhub

DevHub Node.js SDK

Official Node.js SDK for the DevHub Communication API.

Installation

npm install @devotel/devhub

Quick Start

import DevHubSDK from "@devotel/devhub";

const devhub = new DevHubSDK({
  apiKey: "your-api-key",
});

// Send SMS
await devhub.sms.send({
  to: "[phone]",
  message: "Hello from DevHub!",
});

// Send Email
await devhub.email.send({
  to: "[e-mail]",
  subject: "Hello",
  html: "<h1>Hello from DevHub!</h1>",
});

// Send WhatsApp message
await devhub.whatsapp.sendNormalMessage({
  to: "[phone]",
  type: "text",
  text: { body: "Hello from DevHub!" },
});

API Reference

SMS Service

// Send SMS
await devhub.sms.send({
  to: "[phone]",
  message: "Your message",
  from: "optional-sender-id",
});

// Get available senders
await devhub.sms.getSenders();

// Buy a number
await devhub.sms.buyNumber({
  country_code: "US",
  area_code: "555",
});

// Get available numbers
await devhub.sms.getNumbers();

Email Service

// Send email
await devhub.email.send({
  to: "[e-mail]",
  subject: "Subject",
  html: "<p>HTML content</p>",
  text: "Plain text content",
});

WhatsApp Service

// Get WhatsApp accounts
await devhub.whatsapp.getAccounts();

// Send template message
await devhub.whatsapp.sendTemplateMessage("account-id", {
  to: "[phone]",
  template: {
    name: "template-name",
    language: { code: "en" },
  },
});

// Send normal message
await devhub.whatsapp.sendNormalMessage({
  to: "[phone]",
  type: "text",
  text: { body: "Hello!" },
});

// Get templates
await devhub.whatsapp.getTemplates();

Contacts Service

// Get contacts
await devhub.contacts.getContacts();

// Create contact
await devhub.contacts.createContact({
  firstName: "John",
  lastName: "Doe",
  phoneNumber: "[phone]",
  email: "[e-mail]",
});

// Update contact
await devhub.contacts.updateContact("contact-id", {
  firstName: "Jane",
});

// Create custom field
await devhub.contacts.createCustomField({
  name: "Company",
  type: "text",
  required: false,
});

RCS Service

// Get RCS accounts
await devhub.rcs.getAccounts();

// Send RCS message
await devhub.rcs.send({
  to: "[phone]",
  content: { text: "Hello from RCS!" },
});

// Create RCS template
await devhub.rcs.createTemplate({
  name: "greeting",
  content: "Hello {{name}}!",
});

Contact Groups Service

// Get contact groups
await devhub.contactGroups.getContactGroups();

// Create contact group
await devhub.contactGroups.createContactGroup({
  name: "VIP Customers",
  description: "High value customers",
});

// Update contact group
await devhub.contactGroups.updateContactGroup("group-id", {
  name: "Premium Customers",
});

Unified Messages Service

// Send message via any channel
await devhub.messages.send({
  channel: "SMS",
  sms: {
    to: "[phone]",
    message: "Hello!",
  },
});

Error Handling

All methods return a response object with the following structure:

{
  success: boolean,
  data?: any,
  error?: string
}

Example:

const result = await devhub.sms.send({
  to: "[phone]",
  message: "Hello!",
});

if (result.success) {
  console.log("Message sent:", result.data);
} else {
  console.error("Error:", result.error);
}

License

MIT