LangageGuide · SDK officiel bientôt

Envoyez des SMS en Tunisie depuis Node.js avec fetch.

Depuis Node.js 18, fetch est intégré : aucune dépendance n’est nécessaire pour appeler l’API Sendimo depuis Express, NestJS, Next.js ou une fonction serverless. Le SDK JavaScript officiel arrive.

Ce que ça fait

Aucune dépendance avec Node.js 18 ou plus récent.
Fonctionne dans Express, NestJS, les routes API Next.js et les fonctions serverless.
Erreurs JSON avec un code stable pour réagir proprement (rate_limited, insufficient_balance…).
La clé reste côté serveur : ne l’utilisez jamais dans le navigateur ou une app mobile.

Mise en place

1Utilisez Node.js 18 ou plus récent.
2Ajoutez votre clé API dans SENDIMO_API_KEY (fichier .env ou secrets de votre hébergeur).
3Envoyez un POST sur /v1/messages depuis votre serveur.
4Recevez les statuts par webhook et vérifiez leur signature.

Envoyer un SMSJavaScript

// Node.js 18+ (fetch built in)
const response = await fetch("https://api.sendimo.tn/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SENDIMO_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-4821-otp",
  },
  body: JSON.stringify({
    to: "+21620123456",
    from: "SENDIMO",
    text: "Votre code est 482913. Il expire dans 5 minutes.",
    reference: "order-4821",
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.code}: ${error.message}`);
}

const message = await response.json();
console.log(message.id, message.status); // msg_01HF8Z3K9QX2 queued

Réponse 202 AcceptedJSON

{
  "id": "msg_01HF8Z3K9QX2",
  "status": "queued",
  "to": "+21620123456",
  "from": "SENDIMO",
  "text": "Votre code est 482913. Il expire dans 5 minutes.",
  "encoding": "GSM-7",
  "segments": 1,
  "network": "ooredoo",
  "cost": { "amount": "0.140", "currency": "TND" },
  "reference": "order-4821",
  "scheduled_at": null,
  "created_at": "2026-10-30T09:15:00Z"
}