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

- Kanonische URL: https://www.broadnet.me/de/developers/migrate
- Sprache: de
- Zuletzt aktualisiert: 2026-10-21
- Herausgeber: BroadNet (https://www.broadnet.me)
- Markdown-Fassung der Seite, aus der ausgelieferten Seite erzeugt.

Anbieterneutraler Migrationsleitfaden· /developers/migrate

Dieser Leitfaden greift die Konzepte Ihres aktuellen Anbieters auf (Nachrichtenversand, Absender, Zustellbestätigungen und Status-Webhooks) und zeigt die entsprechenden Teile der BroadNet API. Anschließend werden die praktischen Aspekte erläutert: Registrierung der Absender-ID, paralleler Betrieb beider Anbieter, schrittweise Erhöhung des Datenverkehrs, Rollback und die Verantwortlichkeiten für die einzelnen Schritte. Es wird kein Anbieter namentlich genannt, da die Konzepte überall gleich sind.

**Sende eine SMS**

POST /sms/sendSms

**Authentifizierung**

Authorization: Bearer <token>

**Legacy HTTP API**

/websmpp/websms

**SMPP**

Version 3.4, mit Zustellbestätigungen

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

| Konzept | Übliche Form bei anderen Anbietern | BroadNet |
|---|---|---|
| API Host | Ein regionaler API Host für Ihr Konto | `https://api.broadnet.me` Test-Zugangsdaten und die Angabe, wohin Sie Testverkehr senden, erhalten Sie mit Ihrem Testzugang: Fordern Sie ihn unter /signup an, wir antworten innerhalb eines Werktags. |
| Authentifizierung | Eine Konto-ID und ein geheimer Schlüssel über Basic Auth oder ein API Schlüssel-Header | `Authorization: Bearer <token>` Ein Zugriffstoken pro Konto. |
| Sende eine Nachricht | Eine HTTP-POST-Anfrage an einen Nachrichtenendpunkt | `POST /sms/sendSms` Der Anfragetext ist JSON. |
| Absender | `from`, `sender`, `originator` | `senderId` Eine alphanumerische Absenderkennung oder eine pro Land registrierte Nummer. |
| Empfänger | `to`, `destination`, `msisdn` | `destinationNumber` Internationales Format, wie im Spezifikationsbeispiel `447700900101`. |
| Nachrichtentext | `body`, `text`, `content` | `message` Der Text der Nachricht, genau so, wie ihn der Empfänger sehen wird. |
| Zeichenkodierung und Nachrichtenteile | Wird vom Anbieter berechnet oder von einem separaten API Aufruf zurückgegeben. | `messageType` `TEXT` (GSM-7) oder `UNICODE`. `POST /sms/identify` gibt `messageType`, `charCount`, `smsParts` und `charLimit` zurück, bevor Sie senden. |
| Geplanter Versand | Ein `send_at` oder Zeitplanzeitfeld | `isSchedule · gmt · time` Lassen Sie diese Felder leer, um die Nachricht sofort zu senden. |
| Nachrichten-ID | Ein ID-Feld in der JSON-Antwort | `200 OK → 2603121407537573731` Der Antworttext von `/sms/sendSms` ist die Nachrichten-ID. |
| Mehrere Empfänger | Ein Batch-Endpunkt oder eine Schleife | `POST /sms/sendSmsGroupData` Ein `contacts` -Array im Body. `POST /sms/sendbulk` hingegen akzeptiert einen Datei-Upload. |
| Webhook für den Zustellungsstatus | Eine Callback-URL pro Anfrage oder pro Konto | `Webhook URL on your account` Der Lieferstatus wird an die in Ihrem Konto konfigurierte webhook URL gesendet. `POST /sms/resendDlr` sendet die Belege erneut, falls sie dort nicht angekommen sind. |
| Lieferstatusabfrage | Eine GET-Anfrage für die Nachricht anhand ihrer ID | `GET /websmpp/websmsstatus` Legacy HTTP API. Übergeben Sie die Nachrichten-ID als `respid` und `format=json` für JSON. Werte: `DELIVRD`, `UNDELIV`, `EXPIRED`, `REJECTD`. |
| Export des Lieferberichts | Ein CSV-Export in der Konsole | `/websmpp/api/dlrreport` Legacy HTTP API. Ein XLSX-Lieferbericht für einen bestimmten Zeitraum. |
| Fehlermeldungen | Ein HTTP Statuscode plus ein Provider-Fehlercode | `400 · 401 · 500` 400: Validierungsfehler oder fehlendes Feld. 401: Ungültiges oder fehlendes Bearer-Token. 500: Unerwarteter Serverfehler. |
| SMPP | SMPP Sitzungen (Bindungen) an den SMSC des Anbieters | `bind · submit_sm · deliver_sm` SMPP v3.4-Sitzungen als Sender, Empfänger oder Transceiver. Zustellbestätigungen werden als `deliver_sm` empfangen. Ihr Konto enthält die SMPP Anmeldedaten. |
| Senden mit einer HTTP GET-URL | Eine GET-URL mit Anmeldeinformationen in den Parametern | `GET /websmpp/websms` Legacy HTTP API. `user`, `pass` (oder `accesskey` ), `sid`, `mno`, `type`, `text`. Wird für bestehende Integrationen beibehalten; neue sollten `/sms` verwenden. |
| SDK | Eine Clientbibliothek pro Sprache | `@broadnet/cpaas-sdk` Ein offizielles SDK für TypeScript und Node.js. Für andere Sprachen generieren Sie einen Client aus 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`:

POST /sms/sendSms

```
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:

Lieferstatusabfrage

```
# 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)
```

Alle Pfade und Felder auf dieser Seite stammen aus der BroadNet OpenAPI-Spezifikation. Laden Sie diese herunter und überprüfen Sie Ihre Zuordnung anhand der Spezifikation, bevor Sie Code schreiben. [Öffnen Sie die OpenAPI-Spezifikation](https://www.broadnet.me/developers/openapi.yaml)

## 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](https://www.broadnet.me/de/regulations)

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

route.ts

```
// 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](https://www.broadnet.me/de/onboarding)

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

| Aufgabe | Ihr Team | BroadNet |
|---|---|---|
| Feldzuordnung und Codeänderungen | Nehmen Sie die Codeänderungen vor und übernehmen Sie die Kontrolle über den Routing-Switch. | Ihr Migrationsingenieur ordnet Ihre aktuellen Nutzdaten, Absender-IDs und Belege der BroadNet API zu. |
| Anmeldeinformationen | Bewahren Sie das Zugriffstoken sicher auf und halten Sie es von der Quellcodeverwaltung fern. | Gibt das Zugriffstoken und, im Fall von SMPP, die Anmeldeinformationen aus. |
| Registrierung der Absender-ID | Stellen Sie die Unternehmensunterlagen bereit, die die jeweilige Regulierungsbehörde verlangt. | Reicht die Anmeldungen für seine Routen ein und verfolgt jede einzelne bis zur Genehmigung. |
| Routenvalidierung | Bestätigen Sie die Testergebnisse anhand Ihrer eigenen Telefonnummern. | Die Auslieferung wird in jedem Markt vor dem Produktionsbetrieb getestet. |
| Traffic-Erhöhung und Rollback | Legen Sie für jeden Schritt fest, was einen Rollback auslöst und wer diese Entscheidung trifft. | Ein namentlich genannter Migrationsingenieur ist während des Parallelbetriebs und der Umstellung erreichbar. |
| Zustellung, nachdem BroadNet eine Nachricht angenommen hat | Überwachen Sie die Lieferbelege in Ihren eigenen Systemen. | Leitet jede Nachricht von seiner Plattform an den Operator weiter und meldet den Zustellnachweis. |
| Produktionsvorfälle | Melden Sie sie an developers@broadnet.me. | Technischer Support rund um die Uhr für Produktionskunden, mit einer Reaktionszeit von 15 Minuten bei P1-Vorfällen. |
| Außerbetriebnahme der alten Route | Schließen Sie Ihr Konto bei Ihrem bisherigen Anbieter. | Bestätigt, dass Absender-IDs, Durchsatz und Zustellbestätigungen geklärt sind, bevor Sie das Konto schließen. |

## Zugehörige Dokumentation

[Wechseln Sie zu BroadNet Warum Teams zu BroadNet wechseln und wie der vierstufige Umstellungsplan aussieht.](https://www.broadnet.me/de/switch) [API Referenz Bearer-Authentifizierung, Einzel- und Massenversand, Rufnummernabfrage und Fehler.](https://www.broadnet.me/de/developers/api) [Webhooks Der Lieferstatus wird an die webhook URL Ihres Kontos gesendet.](https://www.broadnet.me/de/developers/webhooks)

## Häufig gestellte Fragen

### Muss ich meine Integration neu schreiben, um zu BroadNet zu wechseln?

Normalerweise nicht. Sie ändern den Host, den Authentifizierungsheader und einige Feldnamen: Das Absenderfeld wird zu `senderId`, das Empfängerfeld zu `destinationNumber` und das Textfeld zu `message`. SMPP-Integrationen verweisen ihre bestehende Bindung mit neuen Anmeldeinformationen auf BroadNet.

### Kann ich meine Absenderkennungen behalten?

Grundsätzlich ja, vorbehaltlich der jeweiligen Registrierungsbestimmungen der Betreiber und Regulierungsbehörden. Die Registrierungen für BroadNet-Strecken erfolgen vor der Umstellung: in den VAE gemäß TDRA Bestimmungen und in Saudi-Arabien mit Genehmigung CST und dem Betreiber.

### Wie lange dauert eine Migration?

In den meisten Märkten dauert es von der Discovery-Phase bis zum Go-Live 5–15 Werktage; in Märkten, in denen Regulierungsbehörden länger für die Genehmigung von Absender-IDs brauchen, dauert es länger. Die anschließende Erhöhung des Datenverkehrs dauert so lange, wie Sie es wählen.

### Was passiert, wenn die Zustellungsraten sinken, während ich den Traffic erhöhe?

Reduzieren Sie den Anteil des über BroadNet geleiteten Datenverkehrs auf den letzten erfolgreichen Schritt oder auf null. Ihr aktueller Provider ist weiterhin aktiv, der Datenverkehr fließt also weiter. Überprüfen Sie anschließend die Zustellbestätigungen für das betroffene Land mit Ihrem Migrationsingenieur, bevor Sie es erneut versuchen.

### Wird für die Migrationsunterstützung eine Gebühr erhoben?

Nein. Migrationsunterstützung und das Fenster für parallele Ausführung sind in Ihrem Konto enthalten. Sie zahlen nur für die von Ihnen gesendeten Nachrichten.

## Testzugang anfordern · Antwort innerhalb eines Werktags

Bevor Sie mit dem Produktivverkehr beginnen, sollten Sie sich Zugangsdaten besorgen, Testnachrichten an Ihre eigene verifizierte Nummer senden und Ihre aktuelle Integration mit einem BroadNet Telekommunikationstechniker abgleichen.

[Testzugang anfordern](https://www.broadnet.me/de/signup) [Warum Teams zu BroadNet wechseln](https://www.broadnet.me/de/switch)