Eine Messaging-API für acht Kanäle
Versenden Sie SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-Mail und Push direkt aus Ihrem eigenen Code – mit einer Basis-URL und einem Bearer-Token. Verfolgen Sie jede Nachricht über Webhooks, skalieren Sie SMS über SMPP und lassen Sie KI-Agenten über MCP dieselbe API nutzen.
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
2603121407537573731Ein echter Request: POST /sms/sendSms liefert die Nachrichten-ID als Klartext zurück. Ersetzen Sie Token, Absenderkennung und Nummer durch Ihre eigenen Werte.
Kurze Antwort
Aktualisiert
OmniChannels.ai bietet Entwicklern eine REST-API für SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-Mail und Push. Sie umfasst rund 225 dokumentierte Pfade in einer OpenAPI-3.1-Spezifikation, ein TypeScript-SDK, Webhooks für den Zustellstatus, SMPP v3.4 über TLS und einen MCP-Server für KI-Agenten. Testzugänge senden an Ihre eigenen verifizierten Nummern, Engineers begleiten Ihre Integration, und Reseller können dieselbe API unter eigener Marke nutzen.
Was Sie als Entwickler erhalten
Eine Integration deckt jeden Kanal ab, den Ihre Kunden nutzen – mit dem Tooling, das ein Produktionsteam erwartet.
Eine REST-API, acht Kanäle
SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-Mail und Push teilen sich eine Basis-URL, ein Bearer-Token und ein Fehlerformat. Ein neuer Kanal bedeutet also einen neuen Endpunkt, keinen neuen Anbieter.
OpenAPI 3.1 und ein TypeScript-SDK
Rund 225 dokumentierte Pfade in einer OpenAPI-3.1-Spezifikation, die Sie in Postman importieren oder zur Client-Generierung nutzen können, dazu das offizielle Paket @broadnet/cpaas-sdk für TypeScript und Node.js.
Webhooks für den Zustellstatus
Die Status sind kanalübergreifend vereinheitlicht (SUBMITTED, SENT, DELIVERED, READ, FAILED und REJECTED) und werden an Ihren HTTPS-Endpunkt gepusht – mit Polling- und Re-Push-Endpunkten als Absicherung.
SMPP v3.4 für SMS mit hohem Volumen
Transceiver-Binds über TLS mit IP-Allowlisting, für Ihr Konto bereitgestellt, auf denselben direkten Netzbetreiber-Routen wie die REST-API.
MCP-Server für KI-Agenten
Verbinden Sie Claude, Cursor oder jeden anderen MCP-Client mit Ihrem Token mit der API, sodass Agenten Nachrichten senden und Zustellberichte lesen können – innerhalb Ihrer Leitplanken.
Testen vor dem Go-live
Test-Zugangsdaten senden an Ihre eigenen verifizierten Nummern über dieselbe Basis-URL wie die Produktion. Ihr Code muss beim Umstieg also nicht geändert werden.
Support durch Engineers
Ein Messaging-Engineer prüft Ihren Anwendungsfall, unterstützt beim REST- oder SMPP-Design, bei Absenderkennungen und Länderregeln und begleitet Sie bis zum Go-live.
Für Reseller gemacht
Reseller nutzen dieselbe API unter eigener Marke, mit Unterkonten, die jeweils eigenes Guthaben, eigene Absenderkennungen, Nutzer und Webhooks haben, sowie einer Reseller-API für die Kontoverwaltung.
Die Entwickler-Schnittstellen im Überblick
Was heute verfügbar ist und was gemeinsam mit unserem Team eingerichtet wird.
| Element | Status | Details |
|---|---|---|
| REST-API (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-Mail, Push) | Verfügbar | Basis-URL https://api.broadnet.me mit Bearer-Token-Authentifizierung. Testzugang erhalten Sie nach einer kurzen Anfrage. |
| Webhooks für den Zustellstatus | Verfügbar | Pro Konto oder Unterkonto konfiguriert. Die Status sind kanalübergreifend vereinheitlicht. |
| TypeScript-SDK | Verfügbar | npm install @broadnet/cpaas-sdk axios. Andere Sprachen rufen die REST-API direkt auf oder generieren einen Client. |
| OpenAPI-3.1-Spezifikation | Verfügbar | Öffentlich unter https://omnichannels.ai/developers/openapi.json (YAML unter /developers/openapi.yaml): alle Operationen, die ein Kunden-Token aufrufen kann, für Postman, Insomnia, Client-Generierung und KI-Coding-Tools. |
| MCP-Server | Verfügbar | https://mcp.broadnet.me/mcp über Streamable HTTP, authentifiziert mit Ihrem Token. |
| SMPP v3.4 über TLS | Auf Anfrage | Binds, Durchsatz und IP-Allowlist richtet unser Team für Ihr Konto ein. |
| Sprache (OTP, IVR, ausgehende Anrufe, KI-Sprachagenten) | Auf Anfrage | Wird mit dem Account-Team bereitgestellt; die REST-API bietet keine öffentlichen Voice-Endpunkte. |
Vom ersten Request bis zur Produktion
Eine sofortige Self-Service-Registrierung gibt es nicht. Der Zugang beginnt mit einer kurzen Anfrage, damit das Konto für Ihre Kanäle und Länder eingerichtet wird.
- 1
Testzugang anfragen
Nennen Sie uns Ihre Kanäle, Zielländer, Volumen und Ihren Anwendungsfall. Ein Engineer prüft die Anfrage und stellt Test-Zugangsdaten aus.
- 2
Erste Testnachricht senden
Folgen Sie dem Schnellstart, um eine SMS an Ihre eigene verifizierte Nummer zu senden und den Zustellstatus auf Ihrem Webhook zu empfangen.
- 3
Integration entwickeln
Ergänzen Sie die benötigten Kanäle, behandeln Sie Fehler und Retries und speichern Sie die Nachrichten-IDs. Unsere Engineers können Ihr REST- oder SMPP-Design prüfen.
- 4
Absender freigeben lassen
Absenderkennungen, WhatsApp-Business-Konten und RCS-Agenten werden parallel zu Ihrer Entwicklung registriert – nach den Regeln des jeweiligen Landes und der jeweiligen Plattform.
- 5
Live gehen
Die Produktionsrouten werden für Ihr Konto freigeschaltet. Ihr Code ruft weiterhin dieselbe Basis-URL auf, beim Umstieg ändert sich also nichts.
Passt diese API zu Ihrem Team?
Typische Ausgangslage
- Sie möchten eine einzige Integration für SMS, WhatsApp, RCS, Social Messaging, E-Mail und Push statt mehrerer Anbieter.
- Sie benötigen den Zustellstatus jeder Nachricht in Ihren eigenen Systemen, nicht nur in einem Dashboard.
- Sie versenden hohe SMS-Volumen und möchten SMPP zusätzlich zu REST nutzen.
- Sie verkaufen Messaging weiter und brauchen dieselbe API unter Ihrer Marke, mit Unterkonten.
- Sie entwickeln KI-Agenten, die Nachrichten über MCP senden und verfolgen sollen.
Gut zu wissen, bevor Sie starten
- Es gibt keine sofortige Self-Service-Registrierung; Testzugang erhalten Sie nach einer kurzen Anfrage.
- Das offizielle SDK gibt es nur für TypeScript; andere Sprachen nutzen einfaches HTTP oder einen aus der Spezifikation generierten Client.
- Die API unterstützt keinen Idempotency-Key. Ihre Integration sollte daher jeden Versand protokollieren, bevor sie einen Retry auslöst.
- Voice und SMPP werden mit unserem Team bereitgestellt, nicht über öffentliche Endpunkte.
- Nachrichten über WhatsApp, Messenger und Instagram unterliegen den Regeln von Meta, einschließlich genehmigter Vorlagen und Messaging-Fenster.
Dokumentation
Alles für die Integration, vom ersten API-Aufruf bis zu SMPP-Binds und KI-Agenten. Die technische Dokumentation ist auf Englisch.
- Erste Schritte· Auf EnglischSchnellstart: erste Nachricht sendenTestzugang holen, die erste SMS mit cURL, Node.js, Python oder PHP senden, den Zustellstatus empfangen und prüfen, was vor dem Go-live zu tun ist.
- Erste Schritte· Auf EnglischAuthentifizierungAPI-Anfragen mit einem Bearer-Token authentifizieren, den Token sicher speichern und rotieren, eine 401-Antwort lesen und Facebook-Seiten und Instagram per OAuth verbinden.
- Messaging-Kanäle· Auf EnglischSMS-API-ReferenzEinzel- und Massen-SMS senden, Kodierung TEXT oder UNICODE wählen, Segmente zählen, planen, Massenaufträge steuern und Nummern vor dem Versand prüfen.
- Messaging-Kanäle· Auf EnglischWhatsApp-Business-API-ReferenzWhatsApp-Vorlagen, Text, Medien und interaktive Nachrichten über einen Multipart-Endpunkt senden, Vorlagen und Batches verwalten und jeden Empfänger verfolgen.
- Messaging-Kanäle· Auf EnglischRCS-Business-Messaging-APIRCS-Text, Medien, Rich Cards, Karussells und Antwortvorschläge senden, vorab die Gerätefähigkeit prüfen und den SMS-Fallback für Nutzer ohne RCS planen.
- Messaging-Kanäle· Auf EnglischFacebook-Messenger-APIEine Facebook-Seite per OAuth verbinden und dann Messenger-Text, Medien, Buttons, Karussells und Schnellantworten innerhalb der Meta-Zeitfenster senden.
- Messaging-Kanäle· Auf EnglischInstagram-Messaging-APIEin professionelles Instagram-Konto per OAuth verbinden und Direktnachrichten per API beantworten: Text, Medien, Schnellantworten, generische Vorlagen und Reaktionen.
- Messaging-Kanäle· Auf EnglischTelegram-APITelegram-Text, Fotos, Dokumente, Videos, Standorte und Kontakte vom verbundenen Absender senden, gespeicherte Vorlagen nutzen und in einer Sandbox testen.
- Messaging-Kanäle· Auf EnglischE-Mail-APITransaktions- und Massen-E-Mails über Ihren SMTP-Absender senden: HTML, Vorlagen, Anhänge, CC und Planung, dazu Domainprüfung und Sandbox-Versand.
- Messaging-Kanäle· Auf EnglischPush-Benachrichtigungs-APIPush-Benachrichtigungen an App-Nutzer per Nutzerreferenz, Geräte-Token, Thema oder Segment senden, mit Bildern, Deep Links, Aktionen, Vorlagen und Testläufen.
- Messaging-Kanäle· Auf EnglischVoice: OTP, IVR, Anrufe und KI-AgentenWas Voice bei OmniChannels.ai kann, von Voice-OTP und IVR bis zu KI-Sprachagenten und SMS-zu-Voice-Fallback, und wie unser Team es für Ihr Konto einrichtet.
- Events und Fehler· Auf EnglischWebhooks und ZustellstatusZustellstatus und eingehende Nachrichten am HTTPS-Endpunkt empfangen, schnell antworten, Events deduplizieren und Status bei Bedarf abfragen oder erneut auslösen.
- Events und Fehler· Auf EnglischFehler, Wiederholungen und Rate LimitsHTTP-Statuscodes und Fehlerantworten, welche Fehler mit Backoff und Jitter wiederholt werden, Standard-Rate-Limits, Paginierung und wie doppelte Sendungen vermieden werden.
- Konnektivität· Auf EnglischSMPP-v3.4-KonnektivitätWann SMPP statt REST sinnvoll ist, wie Binds über TLS bereitgestellt werden, das Wichtigste zu submit_sm, Kodierung, Verkettung, Zustellberichten und Fehlercodes.
- Werkzeuge· Auf EnglischMCP-Server für KI-AgentenClaude, Cursor, VS Code und andere MCP-Clients mit der Messaging-API verbinden, damit KI-Agenten mit Ihrem Token sicher Nachrichten senden und verfolgen.
- Werkzeuge· Auf EnglischSDKs, OpenAPI-Spezifikation und CodebeispieleDas TypeScript-SDK nutzen, die OpenAPI-3.1-Spezifikation in Postman oder Insomnia importieren, Clients generieren und die API aus Java, .NET, Go und Ruby aufrufen.
- Werkzeuge· Auf EnglischOpenAPI-3.1-SpezifikationDie öffentliche OpenAPI-3.1-Spezifikation herunterladen, in Postman oder Insomnia importieren, Clients und Typen generieren und KI-Coding-Tools übergeben.
- Werkzeuge· Auf EnglischMCP-Server mit Claude Code nutzenDen MCP-Server von OmniChannels.ai mit claude mcp add zu Claude Code hinzufügen, im Team über .mcp.json teilen, den Token als Umgebungsvariable halten und Sendewerkzeuge absichern.
- Werkzeuge· Auf EnglischMCP-Server mit Cursor nutzenCursor über .cursor/mcp.json mit dem MCP-Server von OmniChannels.ai verbinden, den Token aus einer Umgebungsvariable lesen, Werkzeuge schalten und eine erste Nachricht senden.
- Werkzeuge· Auf EnglischMCP-Server mit n8n nutzenEinem n8n-KI-Agenten mit dem Node MCP Client Tool die Messaging-Werkzeuge geben oder die REST-API aufrufen und Zustellstatus mit normalen n8n-Nodes empfangen.
- Werkzeuge· Auf EnglischMake und Zapier mit WebhooksNachrichten aus Make-Szenarien und Zaps per HTTP-Anfrage an die REST-API senden und Zustellstatus sowie eingehende Nachrichten über einen Make- oder Zapier-Webhook empfangen.
So fügt sich die API in Ihren Stack ein
Ihre Systeme rufen eine REST API mit einem Bearer-Token auf. BroadNet leitet jede Nachricht über den passenden Kanal und Netzbetreiber und sendet die Zustellstatus an Ihren Webhook zurück.
Ihre App, Ihr CRM oder KI-Agent
- Bearer-Token, eine Basis-URL
- SMPP 3.4 über TLS für hohe Volumen
- MCP-Server für KI-Agenten
Messaging-API von BroadNet
Messaging-API von BroadNethttps://api.broadnet.meDas Telefon Ihres Kunden
Zustellstatus an Ihren Webhook
SENTDELIVEREDREADFAILED
Fragen von Entwicklern
Wie authentifiziere ich mich?
Senden Sie den Access-Token Ihres Kontos bei jedem Request im Header Authorization: Bearer. Token werden pro Konto ausgestellt; es gibt keinen Endpunkt, der Benutzername und Passwort gegen ein Token tauscht. Ein fehlendes oder ungültiges Token liefert 401. Bewahren Sie das Token auf Ihren Servern auf, niemals im Browser- oder Mobile-Code.
Wie lautet die Basis-URL, und gibt es eine separate Sandbox?
Alle Aufrufe gehen an https://api.broadnet.me, ohne Versionspräfix. Test und Produktion nutzen dieselbe Basis-URL: Test-Zugangsdaten senden nur an Ihre eigenen verifizierten Nummern, und die Produktion wird nach der Absenderfreigabe für Ihr Konto freigeschaltet. Ihr Code bleibt also unverändert.
Wie erhalte ich Zustellberichte?
Die Status werden an die in Ihrem Konto hinterlegte Webhook-URL gepusht: SUBMITTED, SENT, DELIVERED, READ auf Kanälen mit Lesebestätigung, FAILED und REJECTED. Alternativ können Sie pollen, etwa mit GET /sms/list für SMS-Massenaufträge und GET /whatsapp/message/bulk-insights für WhatsApp-Batches.
Wie gehe ich mit Retries und Duplikaten um?
Wiederholen Sie nur bei Netzwerkfehlern sowie 429- und 5xx-Antworten, mit exponentiellem Backoff und Jitter, und wiederholen Sie 4xx-Fehler nie unverändert. Da die API keinen Idempotency-Key unterstützt, protokollieren Sie jeden Versand vorab, speichern die zurückgegebene Nachrichten-ID und prüfen nach einem Timeout den Status, bevor Sie erneut senden.
Welche Rate Limits gelten?
Die dokumentierten Standardwerte sind 200 Requests pro Sekunde für REST mit Bursts bis 500 für bis zu 60 Sekunden, 1.000 Nachrichten pro Sekunde pro SMPP-Bind und 50 Requests pro Sekunde für Nummernabfragen. Die Limits Ihres Kontos werden mit Ihren Zugangsdaten bestätigt. Requests über dem Limit liefern 429 mit einem Retry-After-Header.
Welche Programmiersprachen werden unterstützt?
Jede Sprache, die HTTPS-Requests ausführen kann. Es gibt ein offizielles TypeScript-SDK, @broadnet/cpaas-sdk, und die Dokumentation enthält HTTP-Beispiele für cURL, Node.js, Python, PHP, Java, .NET, Go und Ruby. Sie können auch einen Client aus der OpenAPI-3.1-Spezifikation generieren, die öffentlich unter /developers/openapi.json verfügbar ist.
Sollte ich für SMS REST oder SMPP nutzen?
REST eignet sich für die meisten Anwendungen und bietet Ihnen alle Kanäle über eine API. SMPP v3.4 über TLS eignet sich für dauerhaft hohe SMS-Volumen, besonders wenn Sie bereits einen SMPP-Client betreiben. Binds, Durchsatz und IP-Allowlists werden für Ihr Konto eingerichtet, und Sie können beides in einem Konto nutzen.
Kann ich Messaging über die API weiterverkaufen?
Ja. Reseller nutzen dieselbe API unter eigener Marke. Jedes Unterkonto hat eigenes Guthaben, eigene Absenderkennungen, Nutzer und Webhooks, und eine Reseller-API deckt Kontoerstellung, Guthabenaufladung, Preislisten und Reporting ab. Erwähnen Sie den Weiterverkauf bei Ihrer Zugangsanfrage, damit wir die Struktur gemeinsam mit Ihnen einrichten.
Leitfäden zu diesem Thema
- IntegrationMessaging-API-Integration: Leitfaden zu REST, SMPP und Webhooks9 Min. Lesezeit
- MarketingGesendet, zugestellt, gelesen, fehlgeschlagen: Nachrichtenstatus8 Min. Lesezeit
- IntegrationCRM mit dem Omnichannel-Posteingang per Webhooks verbinden: So geht es8 Min. Lesezeit
- SMS und OTPOTP per WhatsApp und SMS: Sicherheit, Zustellung, Betrug9 Min. Lesezeit
- WhatsAppWhatsApp-Cloud-API-Fehlercodes: Bedeutung und Lösung8 Min. Lesezeit
- SMS und OTPWas ist A2P-SMS? So gelangen Business-SMS aufs Handy8 Min. Lesezeit
Mehr von der Plattform entdecken
Testzugang anfragen
Nennen Sie uns Ihre Kanäle, Länder und Volumen. Ein Engineer richtet Test-Zugangsdaten für Ihre verifizierten Nummern ein und hilft Ihnen, den Wechsel in die Produktion zu planen.
Beschreiben Sie Ihren Tech-Stack und was Sie anbinden möchten. Ein Solutions Engineer meldet sich bei Ihnen.