Senden Sie Ihre erste Test-SMS fünf Minuten nach Erhalt der Zugangsdaten.
Fordern Sie einen Testzugang an, und wir antworten innerhalb eines Werktags mit Ihren Testzugangsdaten. Nehmen Sie dann den Token, installieren Sie das TypeScript SDK und rufen Sie Folgendes auf: smsSendsmsPost. Ihre erste Testnachricht erreicht Ihre eigene verifizierte Nummer etwa fünf Minuten nach Erhalt der Test-Zugangsdaten. Jedes untenstehende Beispiel ist kopierbereit, und Schritt 5 beschreibt, was vor der Produktion zu prüfen ist.
Ein Weg zu Ihrer ersten Nachricht, mit Zeitangaben für jeden Schritt.
- 01
Testzugang anfordern
Antwort innerhalb von 1 WerktagEin Messaging-Engineer antwortet mit Ihren Testzugangsdaten und vereinbart einen 30-minütigen Call zu Ihren Ländern, Volumina und Ihrem Use Case.
- 02
Erste Testnachricht
Etwa 5 Minuten nach Erhalt der ZugangsdatenSenden Sie mit dem Quickstart-Code eine Testnachricht an Ihre eigene verifizierte Nummer. Die Zustellbestätigung (DLR) wird an Ihren Webhook gesendet.
- 03
Integration
2–5 WerktageErstellen und testen Sie mit Ihren Test-Zugangsdaten gegen denselben Endpunkt wie die Code-Beispiele. Ein BroadNet-Ingenieur unterstützt Sie bei REST oder SMPP.
- 04
Freigabe
3–10 WerktageAbsenderidentität, Traffic-Zweck und Zielregeln werden geprüft und die Sender IDs werden parallel zu Ihrer Integration bei den jeweiligen Regulatoren registriert.
- 05
Produktion
Tag der UmstellungDer Produktionszugriff und die Routen sind für Ihr Konto aktiviert. Ihre Integration ruft bereits https://api.broadnet.me auf.
Insgesamt: 5–15 Werktage von der Anfrage bis zur Produktion in den meisten Märkten; länger, wo die Registrierung der Sender ID beim Regulator länger dauert.
- Ihre AnwendungVersand über REST API oder SMPP
- BroadNet-PlattformValidiert, routet und fakturiert jede Nachricht
- SMSC des BetreibersDirekte Operator-Anbindung
- Endgerät des AbonnentenDie Nachricht wird zugestellt
Holen Sie sich Ihr Zugriffstoken.
Ihr Access Token wird zusammen mit Ihren Test-Zugangsdaten bereitgestellt: Fordern Sie Testzugang an und wir antworten innerhalb eines Werktages. Speichern Sie ihn in der BROADNET_TOKEN-Umgebungsvariable und senden Sie ihn bei jedem Aufruf im Authorization: Bearer Header. Alle Beispiele auf dieser Seite verwenden die Produktions-Base-URL https://api.broadnet.me.
Senden Sie mit POST /sms/sendSms eine Test-SMS an Ihre eigene verifizierte Nummer. Ein 200 OK, dessen Body eine Message-ID enthält, bestätigt, dass der Token funktioniert, bevor Sie weiteren Code schreiben.
Installieren Sie das SDK.
BroadNet bietet ein offizielles SDK für TypeScript und Node.js an: npm install @broadnet/cpaas-sdk axios. Es basiert auf der BroadNet OpenAPI-Spezifikation. In anderen Programmiersprachen können Sie die REST API mit Ihrer gewohnten HTTP Bibliothek aufrufen oder einen Client aus der OpenAPI-Spezifikation generieren.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_tokenImportieren Sie Configuration und SMSSMSApi aus @broadnet/cpaas-sdk. Wenn der Import aufgelöst wird und die Typprüfung besteht, können Sie senden.
Sende deine erste Nachricht.
Erstellen Sie eine SMSSMSApi mit Ihrer Basis URL und Ihrem Token, rufen Sie smsSendsmsPost mit senderId, destinationNumber, message und messageType auf und protokollieren Sie das Ergebnis. Der Antworttext enthält die Nachrichten-ID; speichern Sie diese, um später den Zustellstatus abzugleichen.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDHTTP/1.1 200 OK
2603121407537573731Überprüfen Sie Ihr Handy. Wenn Sie die SMS erhalten haben, ist der schwierigste Teil geschafft – alles Folgende ist nur noch Feinschliff.
Zustellstatus empfangen.
BroadNet sendet den Zustellstatus an die in Ihrem Konto konfigurierte Webhook-URL: SUBMITTED, SENT, DELIVERED, READ bei Kanälen, die Lesebestätigungen melden, oder FAILED und REJECTED. Speichern Sie jede Aktualisierung, antworten Sie schnell mit einem 2xx-Statuscode und verarbeiten Sie sie asynchron.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});Auf dem Mobilgerät bestätigt. Frühere Statusmeldungen wie SUBMITTED und SENT treffen ein, während die Nachricht durch das Netzwerk übertragen wird.
Vom Empfänger geöffnet, auf Kanälen, die Lesevorgänge melden, wie zum Beispiel WhatsApp.
Die Sendung konnte nicht zugestellt werden. Bitte überprüfen Sie das Nummernformat und Ihre Absenderkennung, bevor Sie die Sendung erneut senden.
Senden Sie eine Nachricht an Ihr Telefon und überprüfen Sie anschließend Ihr Serverprotokoll auf die Statusaktualisierung „ DELIVERED “.
Vor der Produktion.
Der Produktionsbetrieb wird freigeschaltet, sobald die Genehmigung erfolgt ist: Absenderidentität, Traffic-Zweck und Absender-IDs, 3–10 Werktage, parallel zu Ihrer Integration. Nach der Genehmigung sendet derselbe Code den Produktions-Traffic. Halten Sie den Token bis dahin von der Versionsverwaltung fern, richten Sie Delivery-Status-Webhooks ein und legen Sie Ihre Retry-Policy fest.
- 01Verschieben Sie Geheimnisse in Ihre Umgebung
Speichern Sie BROADNET_TOKEN in einer Umgebungsvariablen oder Ihrem Geheimnismanager, niemals in der Quellcodeverwaltung oder im clientseitigen Code. Ersetzen Sie es umgehend, falls es jemals kompromittiert wird.
- 02Sicher wiederholen und das Guthaben im Blick behalten
Bei Netzwerkfehlern und 5xx-Fehlern erfolgt ein erneuter Versuch mit exponentiellem Backoff. Jede akzeptierte Sendung liefert eine Nachrichten-ID. Speichern Sie diese und prüfen Sie den Zustellstatus, anstatt die Sendung blind erneut zu senden. Bei Massensendungen wird Ihr verbleibendes Guthaben in jeder Antwort angezeigt.
- 03SDK-Version festlegen
Legen Sie in package.json eine exakte Version @broadnet/cpaas-sdk fest und führen Sie ein gezieltes Upgrade durch. API Pfade enthalten kein Versionspräfix; beachten Sie daher die Änderungen im Changelog und in der OpenAPI-Spezifikation.
- 04Fehlerbehandlung anhand des Statuscodes
Fehler liefern einen HTTP Statuscode und einen Antworttext (ExceptionResponse) mit Status, Fehler, Nachricht, errorCode und requestUri. Beheben Sie 400- und 401-Fehler; versuchen Sie es bei 5xx-Fehlern mit Backoff erneut.
- 05Legen Sie Ihre Wiederholungsrichtlinie fest.
Standardmäßig: Exponentieller Backoff bei 5xx-Fehlern und Netzwerkfehlern, niemals bei 4xx-Fehlern. Nach einem Timeout prüfen Sie den Zustellungsstatus, bevor Sie die Anfrage erneut senden, da die erste Anfrage möglicherweise bereits akzeptiert wurde.
Prüfen Sie Ihren Code anhand der untenstehenden Checkliste. Sobald alle Punkte abgehakt sind, ist Ihre Integration nach Abschluss der Genehmigung bereit für die Produktion.
Über dieselben Codepfade werden täglich über 300 Mio. Nachrichten verarbeitet.
Ihr Testverkehr ist keine Simulation. Jede Anfrage, jeder Key und jeder Webhook, den Sie in den obigen Schritten konfiguriert haben, durchläuft denselben Routing-, Abrechnungs- und Compliance-Stack, der auch unseren Enterprise-Traffic leitet – jährlich geprüft gemäß den unten aufgeführten Zertifizierungen.
Fragen zum Quickstart
POST https://api.broadnet.me/sms/sendSms, mit einem Header Authorization: Bearer und einem JSON-Body mit senderId, destinationNumber, message und messageType (TEXT oder UNICODE). Die Antwort ist die Nachrichten-ID. Die ältere HTTP-API unter /websmpp steht für Integrationen aus der SMPP-Zeit weiterhin zur Verfügung.
Beantragen Sie einen Testzugang unter /signup. Ein BroadNet-Ingenieur antwortet innerhalb eines Werktags mit Ihren Testzugangsdaten: dem Access-Token, das Sie im Header Authorization: Bearer senden, und der Adresse, an die Sie Testtraffic senden. Ihre erste Testnachricht kann etwa fünf Minuten nach Erhalt rausgehen.
Ein offizielles SDK: @broadnet/cpaas-sdk für TypeScript und Node.js, auf npm. In jeder anderen Sprache rufen Sie die REST API direkt über HTTPS auf oder generieren einen Client aus der OpenAPI-Spezifikation (/developers/openapi.yaml).
Die Frage ist nicht dabei? Fragen Sie unser Ingenieurteam
Fünf Stufen nach unten.
Nur noch ein Schlüssel fehlt.
Testen Sie gegen Ihre eigenen verifizierten Nummern, führen Sie die Integration aus und schalten Sie dann über dasselbe Dashboard auf Live-Traffic um. Derselbe SDK, dieselben Endpunkte, dieselben SLAs, die täglich über 300 Mio. Nachrichten bewältigen.