---
title: "Une seule API de messagerie pour huit canaux"
description: "Une seule API REST pour SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail et push, avec webhooks, SMPP, un SDK TypeScript et un serveur MCP."
canonical: "https://omnichannels.ai/fr/developers/"
language: "fr"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Une seule API de messagerie pour huit canaux

Canonical: https://omnichannels.ai/fr/developers/
Language: fr
Publisher: OmniChannels.ai by BroadNet Technologies

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.

**En bref:** 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 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

| Élément | Détails |
|---|---|
| API REST (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail, push) | 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 | Configurés par compte ou sous-compte. Les statuts sont normalisés pour tous les canaux. |
| SDK TypeScript | 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 | 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 | https://mcp.broadnet.me/mcp en Streamable HTTP, authentifié avec votre token. |
| SMPP v3.4 sur TLS | 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) | 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

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.

## 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.

Mis à jour le: 2026-10-10