SDKs oficiales

Clientes oficiales que cubren toda la API como resource clients (mosend.messages.send(...)) y manejan auth, paginación, reintentos y verificación de webhooks por vos. Disponibles en TypeScript/Node y PHP — mismo mapa de 57 resources, verificados 1:1 contra el contrato del backend.

npm (TS) Packagist (PHP) repo TS repo PHP

Quickstart TypeScript →Quickstart PHP →

Instalación

npm i @moshipp/mosend-sdk
# o: pnpm add @moshipp/mosend-sdk  ·  yarn add @moshipp/mosend-sdk
# requiere Node >= 18.17

Primer llamado

Instanciá el cliente con tu API key y tu orgId (ambos del dashboard, en Configuración → Integraciones → API Keys) y enviá una plantilla:

import { MosendClient } from '@moshipp/mosend-sdk';

const mosend = new MosendClient({
  apiKey: process.env.MOSEND_API_KEY!,   // mk_live_<prefix>.<secret>
  orgId: process.env.MOSEND_ORG_ID!,     // UUID de tu organización
});

const msg = await mosend.messages.send({
  phoneNumberId: '<phone-uuid>',
  to: '573001234567',                    // E.164 sin '+'
  type: 'template',
  templateId: '<uuid-de-la-plantilla>',
  variables: ['Juan', 'FAC-2026-0042'],
});

console.log('enviado:', msg.id, msg.metaMessageId);

Guías completas (paginación, errores, sesión JWT, webhooks): TypeScript · PHP.

Qué te dan los SDK

57 resources

Un sub-cliente por módulo de la API (messages, conversations, contacts, broadcasts, billing…). En TS con tipos completos; en PHP con arrays asociativos.

Auth automática

Detecta API key (X-Api-Key) vs JWT (Bearer). El de TS además refresca el JWT (proactivo + reactivo, single-flight).

Paginación, retries, idempotencia

list() / iterate(), reintentos opt-in ante 429/5xx, Idempotency-Key y rate-limit expuesto.

Webhooks seguros

Verificación HMAC SHA-256 timing-safe (verifyWebhookSignature /WebhookVerifier).

Cero dependencias

TS: isomorfo (Node 18+ / browser) sobre fetch nativo, dual ESM+CJS. PHP: solo ext-curl/ext-json (ideal para WooCommerce / hosting compartido), PHP 7.4+. Ninguno arrastra dependencias de runtime.

La referencia detallada de cada endpoint sigue viva en su módulo (ej. /api/messages); los SDK mapean 1:1 con esas rutas.