Une seule API de messagerie pour huit canaux
Envoyez SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail et notifications push depuis votre propre code, avec une seule URL de base et un seul token Bearer. Suivez chaque message grâce aux webhooks, montez en charge sur le SMS avec SMPP et laissez les agents IA utiliser la même API via MCP.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "447700900123",
"message": "Your code is 482913",
"messageType": "TEXT"
}'
# 200 OK
2603121407537573731Une vraie requête : POST /sms/sendSms renvoie l'identifiant du message en texte brut. Remplacez le token, l'identifiant d'expéditeur et le numéro par les vôtres.
En bref
Mis à jour le
OmniChannels.ai offre aux développeurs une seule API REST pour SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail et push. Elle compte environ 225 chemins documentés dans une spécification OpenAPI 3.1, un SDK TypeScript, des webhooks de statut de livraison, SMPP v3.4 sur TLS et un serveur MCP pour les agents IA. L'accès de test envoie vers vos propres numéros vérifiés, des ingénieurs accompagnent votre intégration et les revendeurs peuvent utiliser la même API sous leur propre marque.
Ce que vous obtenez en tant que développeur
Une seule intégration couvre tous les canaux utilisés par vos clients, avec l'outillage qu'attend une équipe en production.
Une API REST, huit canaux
SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail et push partagent une URL de base, un token Bearer et un format d'erreur uniques : ajouter un canal revient à appeler un nouvel endpoint, pas à signer avec un nouveau fournisseur.
OpenAPI 3.1 et SDK TypeScript
Environ 225 chemins documentés dans une spécification OpenAPI 3.1 à importer dans Postman ou à utiliser pour générer des clients, plus le package officiel @broadnet/cpaas-sdk pour TypeScript et Node.js.
Webhooks de statut de livraison
Les statuts sont normalisés pour tous les canaux (SUBMITTED, SENT, DELIVERED, READ, FAILED et REJECTED) et poussés vers votre endpoint HTTPS, avec des endpoints de polling et de renvoi en filet de sécurité.
SMPP v3.4 pour le SMS à fort volume
Binds en mode transceiver sur TLS avec liste blanche d'adresses IP, configurés pour votre compte, sur les mêmes routes opérateurs directes que l'API REST.
Serveur MCP pour les agents IA
Connectez Claude, Cursor ou tout client MCP à l'API avec votre token : vos agents envoient des messages et consultent les rapports de livraison dans le cadre de vos garde-fous.
Testez avant la mise en production
Les identifiants de test envoient vers vos propres numéros vérifiés, sur la même URL de base que la production : votre code ne change pas au moment de la bascule.
Un accompagnement par des ingénieurs
Un ingénieur messagerie étudie votre cas d'usage, vous aide à concevoir l'intégration REST ou SMPP, les identifiants d'expéditeur et les règles par pays, et vous accompagne jusqu'à la mise en production.
Conçue pour les revendeurs
Les revendeurs utilisent la même API sous leur propre marque, avec des sous-comptes disposant chacun de leur crédit, de leurs identifiants d'expéditeur, de leurs utilisateurs et de leurs webhooks, ainsi qu'une API revendeur pour la gestion des comptes.
L'offre développeurs en un coup d'œil
Ce qui est disponible aujourd'hui, et ce qui se met en place avec notre équipe.
| Élément | Statut | Détails |
|---|---|---|
| API REST (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail, push) | Disponible | URL de base https://api.broadnet.me avec authentification par token Bearer. L'accès de test est délivré après une courte demande. |
| Webhooks de statut de livraison | Disponible | Configurés par compte ou sous-compte. Les statuts sont normalisés pour tous les canaux. |
| SDK TypeScript | Disponible | npm install @broadnet/cpaas-sdk axios. Les autres langages appellent directement l'API REST ou génèrent un client. |
| Spécification OpenAPI 3.1 | Disponible | Publique sur https://omnichannels.ai/developers/openapi.json (YAML sur /developers/openapi.yaml) : toutes les opérations qu'un token client peut appeler, pour Postman, Insomnia, la génération de clients et les outils de code IA. |
| Serveur MCP | Disponible | https://mcp.broadnet.me/mcp en Streamable HTTP, authentifié avec votre token. |
| SMPP v3.4 sur TLS | Sur demande | Binds, débit et liste blanche d'adresses IP sont configurés pour votre compte par notre équipe. |
| Voix (OTP, SVI, appels sortants, agents vocaux IA) | Sur demande | Mise en place avec l'équipe de compte ; l'API REST n'expose aucun endpoint vocal public. |
De la première requête à la production
Il n'y a pas d'inscription instantanée en libre-service. L'accès commence par une courte demande, afin que le compte soit configuré pour vos canaux et vos pays.
- 1
Demandez un accès de test
Indiquez-nous vos canaux, pays de destination, volumes et cas d'usage. Un ingénieur étudie la demande et vous délivre des identifiants de test.
- 2
Envoyez votre premier message de test
Suivez le guide de démarrage rapide pour envoyer un SMS à votre propre numéro vérifié et recevoir son statut de livraison sur votre webhook.
- 3
Construisez l'intégration
Ajoutez les canaux nécessaires, gérez les erreurs et les nouvelles tentatives, et enregistrez les identifiants de message. Nos ingénieurs peuvent relire votre conception REST ou SMPP.
- 4
Faites approuver vos expéditeurs
Identifiants d'expéditeur, comptes WhatsApp Business et agents RCS sont enregistrés en parallèle de votre développement, selon les règles de chaque pays et de chaque plateforme.
- 5
Passez en production
Les routes de production sont activées pour votre compte. Votre code continue d'appeler la même URL de base : rien ne change au moment de la bascule.
Cette API est-elle adaptée à votre équipe ?
Adapté si
- Vous voulez une seule intégration pour le SMS, WhatsApp, le RCS, les messageries sociales, l'e-mail et le push, plutôt que plusieurs fournisseurs.
- Vous avez besoin du statut de livraison de chaque message dans vos propres systèmes, pas seulement dans un tableau de bord.
- Vous envoyez de gros volumes de SMS et voulez SMPP en complément de REST.
- Vous revendez de la messagerie et avez besoin de la même API sous votre marque, avec des sous-comptes.
- Vous développez des agents IA qui doivent envoyer et suivre des messages via MCP.
Bon à savoir avant de commencer
- Il n'y a pas d'inscription instantanée en libre-service ; l'accès de test est délivré après une courte demande.
- Le SDK officiel existe uniquement en TypeScript ; les autres langages passent par de simples requêtes HTTP ou un client généré à partir de la spécification.
- L'API ne prend pas de clé d'idempotence : votre intégration doit enregistrer chaque envoi avant toute nouvelle tentative.
- La voix et SMPP sont mis en place avec notre équipe, et non via des endpoints publics.
- Les envois WhatsApp, Messenger et Instagram suivent les règles de Meta, notamment les modèles approuvés et les fenêtres de messagerie.
Documentation
Tout ce qu'il faut pour intégrer l'API, du premier appel aux binds SMPP et aux agents IA. La documentation technique est rédigée en anglais.
- Premiers pas· En anglaisDémarrage rapide : envoyer un premier messageObtenez des identifiants de test, envoyez un premier SMS avec cURL, Node.js, Python ou PHP, recevez le statut de remise et vérifiez les points à régler avant la mise en production.
- Premiers pas· En anglaisAuthentificationAuthentifier les requêtes avec un token Bearer, le stocker et le renouveler en sécurité, interpréter une réponse 401 et connecter Pages Facebook et Instagram via OAuth.
- Canaux de messagerie· En anglaisRéférence de l'API SMSEnvoyer des SMS unitaires et en masse, choisir l'encodage TEXT ou UNICODE, compter les segments, planifier, piloter les envois en masse et vérifier les numéros avant l'envoi.
- Canaux de messagerie· En anglaisRéférence de l'API WhatsApp BusinessEnvoyer modèles, texte, médias et messages interactifs WhatsApp via un seul endpoint multipart, gérer modèles et lots, et suivre chaque destinataire.
- Canaux de messagerie· En anglaisAPI RCS Business MessagingEnvoyer texte, médias, cartes enrichies, carrousels et réponses suggérées en RCS, vérifier d'abord la compatibilité de l'appareil et prévoir le repli SMS.
- Canaux de messagerie· En anglaisAPI Facebook MessengerConnecter une Page Facebook via OAuth, puis envoyer texte, médias, boutons, carrousels et réponses rapides Messenger dans les fenêtres de Meta.
- Canaux de messagerie· En anglaisAPI de messagerie InstagramConnecter un compte Instagram professionnel via OAuth et répondre aux messages privés par API : texte, médias, réponses rapides, modèles génériques et réactions.
- Canaux de messagerie· En anglaisAPI TelegramEnvoyer texte, photos, documents, vidéos, localisation et contacts Telegram depuis votre expéditeur connecté, utiliser des modèles enregistrés et tester en sandbox.
- Canaux de messagerie· En anglaisAPI e-mailEnvoyer des e-mails transactionnels et en masse via votre expéditeur SMTP : HTML, modèles, pièces jointes, copie et planification, plus vérification du domaine et envoi test.
- Canaux de messagerie· En anglaisAPI de notifications pushEnvoyer des notifications push aux utilisateurs de votre app par référence, token d'appareil, sujet ou segment, avec images, liens profonds, actions, modèles et tests à blanc.
- Canaux de messagerie· En anglaisVoix : OTP, SVI, appels et agents IACe que permet la voix sur OmniChannels.ai, de l'OTP vocal et du SVI aux agents vocaux IA et au repli SMS vers voix, et comment notre équipe l'active sur votre compte.
- Événements et erreurs· En anglaisWebhooks et statuts de remiseRecevoir statuts de remise et messages entrants sur votre endpoint HTTPS, répondre vite, dédoublonner les événements, et interroger ou relancer les statuts au besoin.
- Événements et erreurs· En anglaisErreurs, nouvelles tentatives et limitesCodes HTTP et corps d'erreur, erreurs à relancer avec backoff et jitter, limites de débit par défaut, pagination et prévention des envois en double.
- Connectivité· En anglaisConnectivité SMPP v3.4Quand préférer SMPP à REST, comment les binds sont provisionnés sur TLS, l'essentiel de submit_sm, encodage, concaténation, accusés de réception et codes d'erreur.
- Outils· En anglaisServeur MCP pour agents IAConnecter Claude, Cursor, VS Code et d'autres clients MCP à l'API de messagerie pour que des agents IA envoient et suivent des messages en sécurité avec votre token.
- Outils· En anglaisSDK, spécification OpenAPI et exemples de codeUtiliser le SDK TypeScript, importer la spécification OpenAPI 3.1 dans Postman ou Insomnia, générer des clients et appeler l'API depuis Java, .NET, Go et Ruby.
- Outils· En anglaisSpécification OpenAPI 3.1Télécharger la spécification OpenAPI 3.1 publique, l'importer dans Postman ou Insomnia, générer clients et types, et la fournir aux outils de code IA.
- Outils· En anglaisUtiliser le serveur MCP avec Claude CodeAjouter le serveur MCP d'OmniChannels.ai à Claude Code avec claude mcp add, le partager dans .mcp.json, garder le token en variable d'environnement et encadrer les outils d'envoi.
- Outils· En anglaisUtiliser le serveur MCP avec CursorConnecter Cursor au serveur MCP d'OmniChannels.ai avec .cursor/mcp.json, lire le token depuis une variable d'environnement, activer les outils et envoyer un premier message.
- Outils· En anglaisUtiliser le serveur MCP avec n8nDonner à un agent IA n8n les outils de messagerie via le nœud MCP Client Tool, ou appeler l'API REST et recevoir les statuts de remise avec des nœuds n8n classiques.
- Outils· En anglaisMake et Zapier avec les webhooksEnvoyer des messages depuis des scénarios Make et des Zaps par requête HTTP vers l'API REST, et recevoir statuts et messages entrants via un webhook Make ou Zapier.
Comment l'API s'intègre à votre stack
Vos systèmes appellent une seule REST API avec un seul jeton bearer. BroadNet achemine chaque message par le bon canal et le bon opérateur, et renvoie les statuts de livraison sur votre webhook.
Votre application, CRM ou agent IA
- Jeton bearer, une seule URL de base
- SMPP 3.4 sur TLS pour les gros volumes
- Serveur MCP pour les agents IA
API de messagerie BroadNet
API de messagerie BroadNethttps://api.broadnet.meLe téléphone de votre client
Statuts de livraison sur votre webhook
SENTDELIVEREDREADFAILED
Questions des développeurs
Comment s'authentifier ?
Envoyez le token d'accès de votre compte dans un en-tête Authorization: Bearer à chaque requête. Les tokens sont délivrés par compte ; aucun endpoint n'échange un identifiant et un mot de passe contre un token. Un token absent ou invalide renvoie une erreur 401. Conservez le token sur vos serveurs, jamais dans du code navigateur ou mobile.
Quelle est l'URL de base, et existe-t-il une sandbox séparée ?
Tous les appels partent vers https://api.broadnet.me, sans préfixe de version. Test et production utilisent la même URL de base : les identifiants de test n'envoient que vers vos propres numéros vérifiés, et la production est activée pour votre compte après l'approbation des expéditeurs. Votre code ne change donc pas.
Comment obtenir les accusés de réception ?
Les statuts sont poussés vers l'URL de webhook configurée sur votre compte : SUBMITTED, SENT, DELIVERED, READ sur les canaux qui remontent la lecture, FAILED et REJECTED. Vous pouvez aussi interroger l'API, par exemple GET /sms/list pour les envois SMS en masse et GET /whatsapp/message/bulk-insights pour les lots WhatsApp.
Comment gérer les nouvelles tentatives et les doublons ?
Ne relancez que les erreurs réseau et les réponses 429 et 5xx, avec un backoff exponentiel et du jitter, et ne relancez jamais une erreur 4xx à l'identique. L'API ne prend pas de clé d'idempotence : enregistrez chaque envoi avant de l'effectuer, conservez l'identifiant de message renvoyé et vérifiez le statut après un timeout avant de renvoyer.
Quelles sont les limites de débit ?
Les valeurs par défaut documentées sont de 200 requêtes par seconde en REST avec des pics jusqu'à 500 pendant 60 secondes au maximum, 1 000 messages par seconde par bind SMPP et 50 requêtes par seconde pour le number lookup. Les limites de votre compte sont confirmées avec vos identifiants. Les requêtes au-delà de la limite renvoient une erreur 429 avec un en-tête Retry-After.
Quels langages sont pris en charge ?
Tout langage capable d'émettre des requêtes HTTPS. Il existe un SDK TypeScript officiel, @broadnet/cpaas-sdk, et la documentation fournit des exemples HTTP simples en cURL, Node.js, Python, PHP, Java, .NET, Go et Ruby. Vous pouvez aussi générer un client à partir de la spécification OpenAPI 3.1, publique sur /developers/openapi.json.
Faut-il utiliser REST ou SMPP pour le SMS ?
REST convient à la plupart des applications et donne accès à tous les canaux via une seule API. SMPP v3.4 sur TLS convient au SMS à fort volume soutenu, surtout si vous exploitez déjà un client SMPP. Binds, débit et listes blanches d'adresses IP sont configurés pour votre compte, et vous pouvez utiliser les deux sur un même compte.
Puis-je revendre de la messagerie via l'API ?
Oui. Les revendeurs utilisent la même API sous leur propre marque. Chaque sous-compte dispose de son crédit, de ses identifiants d'expéditeur, de ses utilisateurs et de ses webhooks, et une API revendeur couvre la création de comptes, les recharges de crédit, les grilles tarifaires et le reporting. Mentionnez la revente lors de votre demande d'accès pour que nous mettions la structure en place avec vous.
Guides sur ce sujet
- IntégrationIntégration d'API de messagerie : REST, SMPP et webhooks9 min de lecture
- MarketingEnvoyé, délivré, lu, échec : les statuts de message expliqués8 min de lecture
- IntégrationConnecter un CRM à une boîte omnicanale avec des webhooks8 min de lecture
- SMS et OTPOTP par WhatsApp et SMS : sécurité, livraison et fraude9 min de lecture
- WhatsAppCodes d'erreur WhatsApp Cloud API : signification et solutions8 min de lecture
- SMS et OTPSMS A2P : comment les messages pro arrivent sur le mobile8 min de lecture
Découvrir le reste de la plateforme
Demandez un accès de test
Indiquez-nous vos canaux, vos pays et vos volumes. Un ingénieur configurera des identifiants de test pour vos numéros vérifiés et vous aidera à planifier le passage en production.
Présentez-nous votre stack et ce que vous souhaitez connecter. Un ingénieur solutions reviendra vers vous.