Migrieren Sie Ihren SMS-Verkehr von jedem beliebigen Anbieter zu BroadNet.

Ihre bestehende API auf BroadNet abbilden

Die meisten SMS- API verwenden dieselben wenigen Konzepte unter verschiedenen Bezeichnungen. Suchen Sie das entsprechende Konzept in der ersten Spalte (unabhängig von der Bezeichnung Ihres Anbieters) und verwenden Sie das BroadNet Äquivalent. Die Feldnamen entsprechen exakt denen der OpenAPI-Spezifikation.

Hier ist der gleiche Sendevorgang als einzelne Anfrage. Ersetzen Sie die Felder „Absender“, „Empfänger“ und „Text“ Ihres Anbieters durch senderId, destinationNumber und message :

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "ACME",
    "destinationNumber": "447700900101",
    "message": "Your code is 8123",
    "messageType": "TEXT"
  }'

# 200 OK — the response body is the message ID, e.g. 2603121407537573731

Um eine Nachricht zu überprüfen, fragen Sie ihren Status mit der Nachrichten-ID ab, die die Sendeanforderung zurückgegeben hat:

# Status lookup on the legacy HTTP API (/websmpp), by message ID
curl "https://api.broadnet.me/websmpp/websmsstatus?respid=2603121407537573731&format=json" \
  -H "Authorization: Bearer $BROADNET_TOKEN"

# "status": "DELIVRD"   (or UNDELIV, EXPIRED, REJECTD)

Verschieben Sie Ihre Absenderkennungen

Alphanumerische Absenderkennungen und Kurzwahlnummern sind im Allgemeinen portabel, unterliegen jedoch den Registrierungsbestimmungen der jeweiligen Netzbetreiber und Regulierungsbehörden. Die Registrierung ist an den Übertragungsweg Ihres Datenverkehrs gebunden; planen Sie sie daher, bevor Produktionsnachrichten an BroadNet übertragen werden.

1. 1

   Listen Sie jede Absenderkennung, die Länder, in die sie sendet, und die Art des Datenverkehrs auf: OTP, Transaktions- oder Marketingdaten.

2. 2

   Bitte prüfen Sie die jeweiligen Landesbestimmungen. In den VAE werden Absenderkennungen gemäß TDRA Regeln über den Betreiber registriert, wobei pro juristischer Person und Anwendungsfall eine Absenderkennung zulässig ist. In Saudi-Arabien benötigen sie die Genehmigung CST und des Betreibers, und ausländische Absender binden sich über einen CST-lizenzierten lokalen Aggregator ein.

3. 3

   Ihr Migrationsingenieur reicht die Registrierungen für die Routen von BroadNet ein, und das Compliance-Team von BroadNet verfolgt jede einzelne bis zur Genehmigung.

4. 4

   Beginnen Sie den Parallelbetrieb in einem Land erst, nachdem die Absenderkennung dort für die Routen von BroadNet freigegeben wurde. Bis dahin senden Sie weiterhin über Ihren aktuellen Anbieter.

Die Regeln für jeden Markt sind auf den Regulierungsseiten zu finden. SMS-Vorschriften nach Ländern

Führen Sie beide Anbieter parallel aus

Lassen Sie Ihren aktuellen Provider aktiv und fügen Sie BroadNet als zweite Route hinter einem Switch in Ihrem eigenen Code hinzu. Senden Sie zunächst an Ihre verifizierten Rufnummern, dann an einen kleinen Teil des realen Datenverkehrs und vergleichen Sie beide Routen für dieselben Ziele.

Vergleich nach Land und Anbieter:

• Die verschiedenen Zustellstatus: zugestellt, nicht zugestellt, abgelaufen und abgelehnt.
• Die Zeitspanne vom Absenden einer Nachricht bis zum Erhalt der Zustellbestätigung.
• Der auf dem Mobiltelefon angezeigte Absender.
• Die Segmentanzahl für denselben Text, ausgehend von POST /sms/identify.

Wählen Sie die Route pro Empfänger statt pro Nachricht, sodass alle OTP Wiederholungsversuche für einen Benutzer über denselben Anbieter laufen. Ein minimaler Routing-Switch:

// Send a share of recipients through BroadNet; the rest stay on your
// current provider. BROADNET_SHARE is a percentage (0-100) you control.
const BROADNET_SHARE = Number(process.env.BROADNET_SHARE ?? "0");

// Same recipient -> same bucket, so OTP retries stay on one provider.
function bucket(to: string): number {
  let h = 0;
  for (const c of to) h = (h * 31 + c.charCodeAt(0)) >>> 0;
  return h % 100;
}

export async function sendSms(to: string, text: string, senderId: string) {
  if (bucket(to) < BROADNET_SHARE) return sendViaBroadNet(to, text, senderId);
  return sendViaCurrentProvider(to, text, senderId); // your existing code
}

async function sendViaBroadNet(to: string, text: string, senderId: string) {
  const res = await fetch("https://api.broadnet.me/sms/sendSms", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BROADNET_TOKEN}`,
      "Content-Type": "application/json",
    },
    // Use UNICODE for non-GSM text; POST /sms/identify tells you which.
    body: JSON.stringify({ senderId, destinationNumber: to, message: text, messageType: "TEXT" }),
  });
  if (!res.ok) throw new Error(`BroadNet send failed: ${res.status}`);
  return { provider: "broadnet", messageId: await res.text() };
}

Datenverkehr schrittweise erhöhen

Verlagern Sie das Produktionsvolumen schrittweise zu BroadNet, Land für Land oder Anwendungsfall für Anwendungsfall. Bleiben Sie bei jedem Schritt, bis die Lieferbestätigungen mit Ihren Angaben übereinstimmen, und fahren Sie dann mit dem nächsten fort.

1. Testen

   Nur Ihre eigenen, verifizierten Nummern. Bestätigen Sie die Absenderkennung, den Nachrichtentext und die Zustellbestätigungen.

2. 5%

   Ein kleiner Anteil des tatsächlichen Datenverkehrs. OTP Verkehr in ein einzelnes Land liefert schnelle und eindeutige Zustellbestätigungen.

3. 25 %

   Ausreichendes Volumen, um Lieferraten und Lieferzeiten mit Ihrem aktuellen Anbieter zu vergleichen.

4. 100%

   Der gesamte Datenverkehr für dieses Land oder diesen Anwendungsfall. Ihr aktueller Provider bleibt aktiv, bis die Zustellbestätigungen mit Ihren Sendungen übereinstimmen.

Wie lange dauert es

Die Steigerung des Datenverkehrs kann so lange dauern, wie Sie es wünschen. Das Onboarding folgt einem festgelegten Ablauf: Wir beantworten eine Testzugriffsanfrage innerhalb eines Werktages, die technische Integration dauert 2–5 Werktage und die Routenvalidierung mit Genehmigung der Absender-ID 3–10 Werktage. In den meisten Märkten dauert es von der ersten Kontaktaufnahme bis zum Go-Live 5–15 Werktage; in Märkten, in denen die Regulierungsbehörden länger für die Genehmigung von Absender-IDs benötigen, dauert es entsprechend länger. Siehe die Onboarding-Schritte

Wechseln Sie ohne Unterbrechung zurück zu Ihrem aktuellen Anbieter

Um die Änderungen rückgängig zu machen, verwenden Sie denselben Schalter in umgekehrter Reihenfolge: Reduzieren Sie den Prozentsatz des über BroadNet geleiteten Datenverkehrs auf den letzten funktionierenden Schritt oder auf null. Ihre aktuelle Integration und die zugehörigen Sender-ID-Registrierungen bleiben dabei aktiv, daher genügt es, den Prozentsatz zu reduzieren. Es muss nichts neu erstellt werden.

• Halten Sie die Zugangsdaten Ihres aktuellen Anbieters, die Registrierungen der Absender-ID und webhook Endpunkt so lange aktiv, bis der gesamte Datenverkehr umgeleitet wurde und die Zustellbestätigungen mit dem übereinstimmen, was Sie gesendet haben.
• Bevor Sie beginnen, einigen Sie sich darauf, was einen Rollback auslöst, zum Beispiel ein Rückgang des Anteils der in einem Land zugestellten Nachrichten, und wer dies entscheiden darf.
• Lassen Sie Ihren webhook Handler nach einem Rollback weiterhin aktiv: Zustellbestätigungen für bereits über BroadNet gesendete Nachrichten können weiterhin eintreffen.
• Die alte Route sollte erst dann außer Betrieb genommen werden, wenn der gesamte Datenverkehr reibungslos über BroadNet läuft und die Zustellbestätigungen mit den von Ihnen gesendeten Daten übereinstimmen.

Wer ist wofür verantwortlich?

Eine Migration betrifft Ihren Code, Ihre Absenderregistrierungen und den laufenden Datenverkehr. So wird die Arbeit aufgeteilt.

Zugehörige Dokumentation

Häufig gestellte Fragen