SMS8

L'API SMS8 pour les développeurs.

Envoyez des SMS et des MMS avec l'API SMS8, et ils partent de votre propre téléphone. Une seule clé API pour tous les endpoints, des webhooks pour les réponses et les accusés de réception, un SDK pour Node, des classes PHP et C# prêtes à l'emploi, et un serveur MCP pour les agents IA.

SMS8: Copiez votre clé, envoyez avec une seule requête et suivez la livraison avec les webhooks.
Démarrez en une commande
npm install sms8-sdk

Claude Desktop : Réglages, Connecteurs, Ajouter un connecteur personnalisé

Comment fonctionne l'API

Chaque requête va vers app.sms8.io. Vous envoyez un simple formulaire POST avec votre clé API et les champs nécessaires. Vous recevez du JSON, avec un indicateur de succès clair et le détail du message.

Derrière, le message va vers un téléphone Android que vous avez associé, et ce téléphone l'envoie depuis sa propre SIM. Les réponses et les accusés de réception vous reviennent par le même chemin.

L'API n'a pas de limite de débit artificielle. Le débit réel dépend de vos SIM. Ajoutez des téléphones ou utilisez un téléphone double SIM pour envoyer davantage.

Ce que vous pouvez faire

Un endpoint par tâche. La référence complète liste chaque champ.

01

Envoyer des SMS et des MMS

Envoyez un message, un lot à plusieurs personnes, ou une diffusion à une liste de contacts enregistrée. Ajoutez des liens d'images pour les MMS. Programmez un envoi, ou faites-le passer en priorité.

02

Choisir l'expéditeur

Envoyez depuis un téléphone et une SIM, faites tourner l'envoi sur tous vos téléphones, ou choisissez-en un au hasard pour chaque message afin de répartir la charge.

03

Consulter et renvoyer

Retrouvez n'importe quel message par son ID pour voir son statut. Remettez les messages échoués dans la file en un seul appel.

04

Codes OTP

Envoyez un code à usage unique et vérifiez ce que l'utilisateur a saisi. Les codes sont limités par numéro et par jour pour protéger les destinataires.

05

Appareils et contacts

Listez vos téléphones associés et leurs SIM. Créez ou mettez à jour des contacts avec un nom, des étiquettes et des champs personnalisés.

06

USSD

Envoyez un code USSD opérateur, comme une consultation de solde, depuis un téléphone associé et lisez la réponse.

Authentification et réponses

Une clé par compte, la même forme de réponse à chaque appel.

01

Où se trouve la clé

Votre clé s'affiche sur la page API de votre tableau de bord SMS8. Traitez-la comme un mot de passe et gardez-la sur votre serveur, pas dans une page web publique.

02

Comment l'envoyer

Placez-la dans l'en-tête X-Api-Key, comme dans le fichier OpenAPI. Un jeton bearer dans l'en-tête Authorization ou un champ de formulaire nommé key fonctionnent aussi.

03

Ce qui revient

Du JSON avec un indicateur de succès. En cas de succès, vous recevez le message ou l'enregistrement. En cas d'échec, une erreur avec un code et un court message.

04

Vérifiez l'indicateur

Certaines erreurs, comme des champs incorrects ou plus de crédits, reviennent dans une réponse normale. Lisez l'indicateur de succès avant de vous fier au résultat.

05

Quand la clé est fausse

Une clé absente ou invalide renvoie 401. Des champs absents ou mal formés renvoient 400.

Les endpoints en un coup d'œil

Tous sous app.sms8.io. Le fichier OpenAPI donne les champs exacts de chacun.

CheminMéthodeCe qu'il fait
/api/v1/messagesPOSTEnvoyer un SMS ou un MMS à une personne ou à un lot
/api/v1/messages/readPOSTLister les messages envoyés et reçus, filtrés par numéro, sens ou date
/api/v1/messages/resendPOSTRelancer un message échoué, par son ID
/api/v1/devicesGETLister les téléphones associés avec batterie, réseau, SIM et dernière connexion
/api/v1/contactsPOSTCréer ou mettre à jour un contact avec étiquettes et champs personnalisés
/api/v1/ussd/sendPOSTLancer un code USSD depuis une SIM associée et obtenir la réponse de l'opérateur
/api/v1/ussd/listPOSTLister vos sessions USSD récentes

Envoyer un message, champ par champ

Seuls le numéro et le texte sont obligatoires. Tout le reste a une valeur par défaut.

01

Numéro et texte

Le numéro se met au format international, comme +14155550100. Le texte peut faire jusqu'à 1 000 caractères et utiliser des balises de fusion comme {first_name}.

02

SMS ou MMS

Le type est sms par défaut. Pour un MMS, ajoutez des liens d'images HTTPS publics. SMS8 redimensionne chaque image à 1 280 pixels avant l'envoi.

03

Quel téléphone envoie

Indiquez un ou plusieurs ID d'appareil et un emplacement SIM, où 0 correspond à la SIM 1 et 1 à la SIM 2. Sans eux, c'est votre téléphone par défaut qui envoie.

04

Rotation

Activez l'option pour alterner entre tous vos téléphones, ou entre toutes les SIM de tous les téléphones. Un téléphone au hasard par message est aussi possible.

05

Passer en priorité

Marquez un message comme prioritaire et il passe devant les autres en attente sur ce téléphone. Utile pour les alertes et les codes.

06

Ce que vous recevez

Un ID de message pour les recherches ultérieures, le téléphone et la SIM qui l'ont pris, et l'heure de mise en file. Le statut passe ensuite par en file, en cours, envoyé, délivré ou échec.

Webhooks

Enregistrez une URL et SMS8 y envoie les événements au moment où ils se produisent. Chaque webhook choisit ses événements et a son propre secret de signature, pour vérifier que chaque requête vient bien de SMS8.

01

Reçu

Une réponse ou un nouveau message est arrivé sur l'un de vos téléphones. Celui dont la plupart des intégrations CRM ont besoin.

02

Envoyé

Votre téléphone a pris le message et l'a mis en file sur sa SIM. Utile pour les journaux d'audit.

03

Délivré

L'opérateur du destinataire a confirmé la remise.

04

Échec

Le message n'a pas pu être envoyé après plusieurs tentatives, par exemple à cause d'un mauvais numéro ou d'une absence de réseau.

05

Réponse USSD

L'opérateur a répondu à un code USSD que vous avez envoyé.

06

Téléphone associé

Un nouveau téléphone a rejoint votre compte.

Signés, relancés et journalisés

Chaque requête de webhook porte un en-tête X-Signature. C'est un hachage HMAC-SHA256 du corps brut de la requête, calculé avec le secret propre à ce webhook, pas avec votre clé API. Calculez le même hachage sur votre serveur, comparez les deux avec une vérification à temps constant, et rejetez tout ce qui ne correspond pas.

Votre récepteur doit utiliser HTTPS et répondre avec un statut 2xx en moins de 10 secondes. Sinon, SMS8 réessaie selon un calendrier qui s'allonge de quelques minutes jusqu'à 30 jours. Chaque tentative apparaît dans le journal des envois avec le statut et la réponse, et vous pouvez relancer n'importe quelle ligne à la main.

Répondez d'abord et faites le travail lent ensuite, comme les recherches dans le CRM ou une classification par IA. Utilisez l'ID du message comme clé unique pour qu'un événement relancé ne soit jamais traité deux fois.

Pour les agents IA

Le serveur MCP de SMS8, sur mcp.sms8.io, permet à Claude, Cursor et aux autres outils d'IA d'envoyer des SMS, d'envoyer et vérifier des codes OTP, de lire les messages, de lister vos téléphones et de configurer des webhooks.

Il utilise la même clé API, envoyée comme jeton bearer. Ajoutez-le une fois à votre outil d'IA et votre agent peut envoyer des SMS depuis votre numéro.

Questions fréquentes

Encore un doute ? Nous répondons vite.

Envoyez votre clé API avec chaque requête. Vous la trouvez sur la page API de votre tableau de bord. Le serveur MCP accepte la même clé comme jeton bearer.

L'API n'a pas de limite artificielle. Ce sont vos SIM qui fixent le vrai rythme. Pour les gros envois, ajoutez des téléphones ou réglez un délai entre les messages dans vos paramètres.

Abonnez un webhook aux événements délivré et échec, ou retrouvez le message par son ID.

Oui. Réglez le type sur MMS et ajoutez des liens d'images publics. SMS8 redimensionne les images avant l'envoi.

Oui. Les endpoints actuels se trouvent sous /api/v1, et les anciennes URL continuent de fonctionner pour les apps existantes.

Non. Chaque webhook a son propre secret de signature, défini à sa création. Votre clé API ne sort jamais de vos requêtes vers SMS8.

Les événements attendent dans la file de relance et SMS8 continue d'essayer pendant jusqu'à 30 jours. Vous pouvez aussi renvoyer n'importe quel envoi depuis le journal une fois revenu.

Oui. Importez le fichier OpenAPI dans Postman, Insomnia ou un générateur de code pour obtenir chaque endpoint et chaque champ.

Oui. Passez un ID d'appareil et un emplacement SIM, ou laissez SMS8 alterner entre vos téléphones et vos SIM pour répartir la charge.

Envoyez votre premier appel API

Créez un compte, associez un téléphone et copiez votre clé API. Votre code peut envoyer en quelques minutes.