LangageGuide · SDK officiel bientôt

Envoyez des SMS en Tunisie depuis Python avec l’API Sendimo.

Avec la librairie requests, un seul appel HTTP suffit pour envoyer un SMS depuis vos scripts, vos applications Django, Flask ou FastAPI. Le SDK Python officiel arrive ; le code ci-dessous fonctionne dès aujourd’hui.

Ce que ça fait

Codes OTP, confirmations de commande et alertes.
Envoi en masse jusqu’à 10 000 SMS par appel avec POST /messages/bulk.
Clé de test sk_test_ : réponses réalistes, rien n’est envoyé ni facturé.
En-tête Idempotency-Key pour réessayer sans jamais envoyer deux fois.

Mise en place

1Installez requests : pip install requests
2Créez une clé API dans votre espace Sendimo et exportez-la dans SENDIMO_API_KEY.
3Envoyez un POST sur /v1/messages : la réponse 202 contient l’identifiant du message.
4Recevez le statut final (delivered, failed…) par webhook.

Envoyer un SMSPython

import os
import requests

response = requests.post(
    "https://api.sendimo.tn/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['SENDIMO_API_KEY']}",
        "Idempotency-Key": "order-4821-otp",
    },
    json={
        "to": "+21620123456",
        "from": "SENDIMO",
        "text": "Votre code est 482913. Il expire dans 5 minutes.",
        "reference": "order-4821",
    },
    timeout=10,
)
response.raise_for_status()  # 4xx/5xx → exception, see error.code

message = response.json()
print(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"
}