Aller au contenu principal

SMS par API

Envoyez des SMS par API,
depuis votre propre numéro.

Installez l'app Android gratuite, connectez-vous, et chaque SMS envoyé via l'API Unlimited Messaging part de la carte SIM de votre téléphone, sur votre forfait. Vos destinataires voient votre numéro, les réponses reviennent dans votre boîte et vos webhooks, et la même requête peut aussi partir sur WhatsApp et par email.

Pressé ? Résumez cet article avec une IA

Le contexte

Envoyer des SMS par API depuis son téléphone, concrètement ?

Envoyer des SMS par API depuis votre numéro, c'est appeler un endpoint REST depuis votre code et voir le texte partir comme un SMS normal d'un téléphone qui vous appartient. Chez Unlimited Messaging, ce téléphone fait tourner notre app Android gratuite et open source.

Les API SMS classiques fonctionnent autrement. Vous louez un numéro expéditeur ou un short code auprès d'un fournisseur, le message passe par le réseau A2P (application-to-person) et chaque segment de 160 caractères est facturé, à un tarif qui change d'un pays à l'autre. Aux États-Unis, il faut en plus enregistrer une marque et une campagne (A2P 10DLC) avant d'envoyer.

Avec l'app Android, le téléphone garde une connexion ouverte vers l'API Unlimited Messaging. Quand vous appelez POST /message avec "channel": "SMS", l'API transmet le message au téléphone, qui l'envoie depuis sa SIM, et chaque statut remonte au fil des confirmations du réseau : en file, en cours d'envoi, envoyé, distribué si votre opérateur renvoie des accusés de réception, non distribuable ou en échec. Le SMS n'a pas d'accusé de lecture : pas de statut "lu".

Le SMS part sur votre forfait : Unlimited Messaging n'ajoute aucun frais par message, et vos destinataires voient le numéro qu'ils connaissent déjà. Les SMS reçus après la connexion reviennent dans votre boîte de réception et dans le webhook message.received. C'est fait pour votre propre trafic, à un rythme humain : rappels, codes, relances, un agent IA qui écrit à vos clients. Les campagnes de masse restent le métier d'un fournisseur SMS dédié.

Illustration : un téléphone avec des bulles de SMS et une étiquette SMS, avec le titre « Le SMS s'arrête à 160 caractères ».

La requête

Un curl pour envoyer un SMS, une ligne de plus pour WhatsApp et l'email

Le canal SMS utilise le même endpoint POST /message que WhatsApp et l'email. Indiquez-le dans channels avec un numéro de téléphone, et il part de votre téléphone. Ajoutez jusqu'à trois canaux pour joindre la même personne partout en une requête.

curlShell
curl https://api.unlimitedmessaging.app/message \
  -H "Authorization: Bearer $UM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": {
    "phone": "+33612345678"
  },
  "channels": [
    {
      "channel": "SMS"
    }
  ],
  "text": "Votre rendez-vous est demain à 10h."
}'
Un SMS depuis votre propre SIM. En double SIM, ajoutez "accountId" dans l'entrée du canal pour choisir la ligne.
POST /messageJSON
{
  "to": {
    "phone": "+33612345678",
    "email": "[email protected]"
  },
  "subject": "Votre rendez-vous demain à 10h",
  "text": "Bonjour, petit rappel : votre rendez-vous est demain à 10h. Répondez à ce message si vous devez le déplacer.",
  "channels": [
    {
      "channel": "WHATSAPP"
    },
    {
      "channel": "SMS",
      "text": "Votre rendez-vous est demain à 10h."
    },
    {
      "channel": "EMAIL"
    }
  ]
}
Une requête, trois messages : chaque canal reçoit sa copie, sous un même dispatchId. L'entrée SMS remplace le texte par une version plus courte.

Comparatif

API SMS classique ou SMS depuis votre téléphone

Les deux envoient un SMS depuis votre code, mais ne servent pas les mêmes besoins. Voici, honnêtement, où chacun est le meilleur choix.

API SMS classique ou SMS depuis votre téléphone
API SMS classiquetype Twilio, A2PUnlimited Messagingvotre téléphone Android
ExpéditeurNuméro ou short code loué au fournisseurVotre propre numéro, celui que vos clients connaissent
Coût par SMSFacturé par segment de 160 caractères, selon le paysVotre forfait, aucun frais par SMS ajouté par nous
Mise en placeAcheter un numéro, enregistrer l'expéditeur (A2P 10DLC aux US)Installer l'app, se connecter, la SIM apparaît
VolumeDébit élevé, pensé pour les campagnesRythme humain, environ 30 SMS par fenêtre avant qu'Android demande
InfrastructureRien à faire tourner de votre côtéUn téléphone allumé, chargé et connecté
RéponsesWebhook vers votre serveurMême boîte et même webhook que WhatsApp et l'email
Autres canauxSMS seul, ou produits séparésWhatsApp, email et SMS dans une seule requête
Statut de remiseAccusés de réception opérateurEnvoyé, et distribué quand votre opérateur le signale

Notre approche

Le SMS comme un canal de plus de la même API

Nous n'avons pas monté un fournisseur SMS. Nous avons fait de votre téléphone un canal de l'API que vous utilisez déjà pour WhatsApp et l'email, avec les mêmes statuts, webhooks, SDK et serveur MCP.

Votre SIM, votre numéro, votre forfait

Le SMS part du téléphone que vous avez en poche ou posé sur un bureau. Vos destinataires voient votre numéro habituel, et le coût est celui que votre forfait facture déjà.

  1. Dans les deux sens

    Les SMS reçus après la connexion reviennent dans votre boîte et dans le webhook message.received, à côté de vos conversations WhatsApp et email.

  2. Double SIM

    Chaque SIM devient son propre compte SMS. Choisissez la ligne message par message avec accountId, ou laissez l'API choisir.

  3. Open source, sans pistage

    L'app est sous licence MIT, sans Firebase, sans Play Services ni analytics. Vous pouvez lire exactement ce que fait une app qui détient les permissions SMS.

Frais par SMS ajouté par Unlimited Messaging
0Frais par SMS ajouté par Unlimited Messaging
Canaux par requête : WhatsApp, SMS, email
3Canaux par requête : WhatsApp, SMS, email
Caractères max par SMS, en 10 parties au plus
1530Caractères max par SMS, en 10 parties au plus
Version d'Android requise
8.0+Version d'Android requise

Comment ça marche

Votre premier SMS en trois étapes

  1. 01

    Installez l'app

    Téléchargez l'APK sur votre téléphone Android depuis la page Android ou les releases GitHub. L'app n'est pas sur Google Play, qui réserve les permissions SMS aux applis SMS par défaut. Si Play Protect bloque l'installation ou si Android refuse la permission SMS, la FAQ ci-dessous explique comment débloquer.

  2. 02

    Connectez-vous

    Touchez Se connecter : la page de connexion du site s'ouvre dans un onglet (email, lien magique, Google ou GitHub). L'app ne voit jamais votre mot de passe, et chaque SIM apparaît comme un compte SMS.

  3. 03

    Envoyez

    Appelez POST /message avec "channel": "SMS", ou envoyez depuis le tableau de bord, les SDK, n8n ou un assistant IA via le serveur MCP. Statuts et réponses arrivent par webhook.

FAQ

Questions sur l'envoi de SMS par API depuis votre téléphone

Ilian, ingénieur logiciel senior

Écrit par

· Senior Software Engineer

Ingénieur logiciel senior, il fonde et dirige plusieurs sociétés tech. Il conçoit des produits autour des API de messagerie, de l’automatisation et de l’intégration de l’IA, et partage ici ce qu’il apprend en construisant.

Voir le profil LinkedInMis à jour le

Faites de votre téléphone une passerelle SMS.

Téléchargez l'app Android gratuite, connectez-vous et envoyez dès aujourd'hui votre premier SMS par API depuis votre numéro.