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.

npm install sms8-sdkclaude mcp add --transport http sms8 https://mcp.sms8.ioSMS8_API_KEY=your_api_key npx -y sms8-sdk mcphttps://mcp.sms8.ioClaude 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.
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é.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
| Chemin | Méthode | Ce qu'il fait |
|---|---|---|
| /api/v1/messages | POST | Envoyer un SMS ou un MMS à une personne ou à un lot |
| /api/v1/messages/read | POST | Lister les messages envoyés et reçus, filtrés par numéro, sens ou date |
| /api/v1/messages/resend | POST | Relancer un message échoué, par son ID |
| /api/v1/devices | GET | Lister les téléphones associés avec batterie, réseau, SIM et dernière connexion |
| /api/v1/contacts | POST | Créer ou mettre à jour un contact avec étiquettes et champs personnalisés |
| /api/v1/ussd/send | POST | Lancer un code USSD depuis une SIM associée et obtenir la réponse de l'opérateur |
| /api/v1/ussd/list | POST | Lister 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.
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}.
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.
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.
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.
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.
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.
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.
Envoyé
Votre téléphone a pris le message et l'a mis en file sur sa SIM. Utile pour les journaux d'audit.
Délivré
L'opérateur du destinataire a confirmé la remise.
É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.
Réponse USSD
L'opérateur a répondu à un code USSD que vous avez envoyé.
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.
SDK et langages
Tout langage capable de faire une requête web fonctionne. Ceux-ci vous évitent la mise en place.
Node et TypeScript
Installez sms8-sdk depuis npm. Un seul package pour le SDK, un outil en ligne de commande, des helpers React et le pont MCP.
02PHP
Une classe PHP avec une méthode pour chaque endpoint. Enregistrez le fichier, faites un require et envoyez. Fonctionne sur PHP 7.4 et versions ultérieures et ne demande que l'extension curl, donc convient à Laravel, WordPress, Symfony ou un simple script.
03C# et .NET
Une classe basée sur HttpClient avec des méthodes asynchrones. Fonctionne sur .NET moderne, .NET Framework 4.6.2 et versions ultérieures, Unity, Xamarin et MAUI.
04Python et autres
La référence montre chaque requête prête à copier dans votre langage. Le générateur du tableau de bord vous permet d'essayer une requête sur votre vrai compte.
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.
Référence complète
Tout, avec les champs exacts, les réponses et les codes d'erreur, se trouve ici.
Référence API
Chaque endpoint, champ et code d'erreur, avec un générateur pour essayer des requêtes sur votre compte.
Ouvrir la référenceFichier OpenAPI
Importez la spécification dans Postman, Insomnia ou votre générateur de code.
Obtenir openapi.yamlRéglages des webhooks
Ajoutez une URL de webhook, choisissez les événements et consultez le journal des envois.
Ouvrir les webhooksEnvoyez 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.