Eine Messaging-Marke außer Betrieb nehmen

Ablauf für die Außerbetriebnahme wählen

Nehmen Sie eine Messaging-Marke außer Betrieb, wenn das Unternehmen diese Registrierung nicht mehr benötigt. Damit wird die bestehende Registrierung nicht mehr verwendet; es wird weder eine Ersatzregistrierung angelegt noch werden gemietete Rufnummern freigegeben oder Angaben zur Unternehmensidentität korrigiert. Verwenden Sie für eine Korrektur Eine Messaging-Marke aktualisieren.

Der öffentliche DELETE-Aufruf für Marken und die Portalaktion „Marke löschen“ haben einen unterschiedlichen Umfang. Der öffentliche Aufruf löscht eine einzelne Marke im Register. Das Portal koordiniert das Aufheben der Rufnummernzuordnungen und die Deaktivierung der Kampagnen, bevor es versucht, die Marke zu löschen.

Auswirkungen im Portal prüfen

Öffnen Sie die Seite zur Messaging-Registrierung, suchen Sie die richtige Marke und wählen Sie „Marke löschen“. Prüfen Sie die Anzahl der zugehörigen Kampagnen und der zugeordneten Rufnummern. Geben Sie die exakte Marken-ID ein, um die abschließende Aktion freizuschalten. Das Kundenformular ist nur verfügbar, wenn das Konto über die Berechtigung zur Registrierungsverwaltung verfügt.

Das Portal verarbeitet aktive Kampagnen nacheinander: Es versucht, die Zuordnung jeder aktuell zugeordneten Rufnummer aufzuheben, deaktiviert die Kampagne und löscht anschließend die Marke. Bei Kampagnen, die bereits als abgelaufen oder gelöscht gekennzeichnet sind, überspringt es einen erneuten Löschvorgang im entfernten System. Nachdem diese externen Schritte erfolgreich abgeschlossen wurden, aktualisiert es die lokalen Kampagnen- und Rufnummerndatensätze in einer Datenbanktransaktion.

Diese Abfolge ist keine einzelne atomare Transaktion über das Register, den Netzbetreiber und die lokalen Datensätze hinweg. Ein späterer Fehler kann eine Rufnummer oder Kampagne, die extern bereits geändert wurde, nicht wiederherstellen. Bewahren Sie die zurückgegebenen Angaben zu Rufnummern mit aufgehobener Zuordnung und deaktivierten Kampagnen auf, sofern diese verfügbar sind; gleichen Sie die Zustände anhand dieser Kennungen ab, anstatt eine weitere Marke anzulegen.

Direktes Löschen über die API vorbereiten

Verwenden Sie ein aktiviertes API-Konto über HTTPS von einer zulässigen Quell-IP-Adresse aus. Die Marke muss diesem Konto gehören. Lesen Sie ihre ID und ihren aktuellen Zustand aus und bewahren Sie diese Angaben auf. Prüfen Sie anschließend ihre Kampagnen und Rufnummernzuordnungen. Heben Sie die Zuordnung der betroffenen Rufnummern auf und deaktivieren Sie Kampagnen, bevor Sie die Marke löschen. Betrachten Sie diesen DELETE-Aufruf nicht als kaskadierenden Vorgang.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Die geprüfte Marke löschen

Führen Sie den folgenden Aufruf nur für die beabsichtigte Außerbetriebnahme aus, nachdem Sie die Marken-ID geprüft und die vorangehende Bereinigung abgeschlossen haben. Die Anfrage enthält keinen JSON-Body.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Das dokumentierte Erfolgsergebnis ist HTTP 204 ohne Antwort-Body. Setzen Sie weder ein JSON-Erfolgsobjekt noch die veraltete v3-Hülle mit status/response voraus. Ein abgewiesenes Ergebnis außerhalb des 2xx-Bereichs kennzeichnet die Marke über den aktuellen Synchronisierungspfad der API nicht als gelöscht.

Verwenden Sie einen einzigen Idempotenzschlüssel für die beabsichtigte Anfrage. Lassen Sie bei einer Wiederholung Methode, Pfad, Abfrage und Body bytegenau unverändert. Der Schlüssel macht die umfassendere Bereinigung im Portal nicht atomar und belegt nicht, dass die Zuordnung einer Rufnummer beim Netzbetreiber aufgehoben wurde. Ein Duplikat einer noch laufenden Anfrage kann 409 mit Retry-After zurückgeben; bei abgeschlossenen Anfragen kann die gespeicherte Antwort erneut ausgegeben werden, einschließlich eines Fehlers.

Außerbetriebnahme prüfen und Teilergebnisse abgleichen

Prüfen Sie nach dem Vorgang die Marken- und Kampagnenlisten im Portal sowie die betroffenen Rufnummern. Die Synchronisierung nach einem erfolgreichen Aufruf der öffentlichen API kennzeichnet die einzelne Marke lokal als gelöscht; sie entfernt weder die übrigen Kampagnenressourcen noch hebt sie die Zuordnungen gekaufter Rufnummern auf. Der Status im Register, die Zuordnung beim Netzbetreiber und die lokale Anzeige müssen gesondert geprüft werden.

Der aktuelle Netzbetreiberadapter des Portals akzeptiert eine HTTP-Erfolgsantwort, ohne jeden fachlichen Statuswert in ihrem Body gesondert zu validieren. Prüfen Sie deshalb nach einer Bereinigung im Portal die tatsächlichen Kampagnenzuordnungen der betroffenen Rufnummern, auch wenn das Portal Erfolg gemeldet hat. Falls eine Zuordnung oder ein Status widersprüchlich ist, bewahren Sie die betroffenen IDs auf und wenden Sie sich an den Support, bevor Sie über die außer Betrieb genommene Konfiguration Nachrichten senden oder diese Konfiguration erneut anlegen.

Lesen Sie bei HTTP 400 die ausführliche Fehlermeldung des Registers, insbesondere eine Einschränkung aufgrund einer aktiven Kampagne. Prüfen Sie bei 401, 403 oder 404 die Zugangsdaten, die zulässige Quell-IP-Adresse und die Zugehörigkeit zum Konto. Beachten Sie bei 429 den Header Retry-After. Eine Zeitüberschreitung, 500 oder 502 kann nach einer bereits abgeschlossenen externen Änderung auftreten; prüfen Sie die bestehende Registrierung, bevor Sie die Anfrage wiederholen.

Verbleibende Kontogebühren prüfen

Der aktuelle DELETE-Dienst löst keine sofortige Abbuchung für die Markenregistrierung aus. Durch das Löschen einer Marke werden weder die gemieteten Rufnummern freigegeben noch eine Erstattung veranlasst oder der endgültige Kontostand festgestellt. Prüfen Sie im Portal alle bestehenden Kampagnenverpflichtungen sowie Rufnummernmiet- und Nutzungsgebühren. Dieser Vorgang stellt kein Preisangebot für diese separaten Leistungen dar.