Eine Messaging-Marke registrieren

Registrieren Sie das Unternehmen hinter Ihren Nachrichten

Eine Messaging-Marke identifiziert das Unternehmen, das in den USA Nachrichten über 10DLC versendet. Registrieren Sie die Marke, bevor Sie einen Kampagnen-Anwendungsfall wählen. Verwenden Sie die rechtlichen Angaben des Unternehmens und eine Kontaktperson, die jede erforderliche Validierung abschließen kann. Eine zurückgegebene Marken-ID ist für sich genommen keine Freigabe zum Versand von Nachrichten.

Verwenden Sie diese aktuelle kontoeigene Route über HTTPS mit einem aktivierten API-Konto und dessen zugelassener Quell-IP-Adresse. Übermitteln Sie weder user_id, username noch die Eigentümerkennung eines anderen Kunden. MultiTEL erfasst die Eigentümerschaft anhand des authentifizierten Kontos.

Beginnen Sie mit einer expliziten Sandbox-Anfrage

Das Portal setzt das Feld mode seines Formulars standardmäßig auf Sandbox; eine direkte API-Anfrage muss den JSON-Booleschen Wert mock: true explizit enthalten, wenn Sie eine Mock-Marke beabsichtigen. Das Weglassen dieses Flags ist keine Sandbox-Garantie und kann eine kostenpflichtige Produktionsregistrierung erzeugen. Das Feld mode des Portals ersetzt nicht das Feld mock der API.

Bereiten Sie eine lokale Datei brand.json mit den unten stehenden Feldern vor. Ersetzen Sie die Platzhalter durch geeignete Testangaben und aktuelle Katalogcodes. Dieses Beispiel ist ein gewinnorientiertes Privatunternehmen; andere Entitätstypen haben andere Anforderungen.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

Unternehmen, Adresse, Telefonnummer und Kennung oben sind Platzhalter, keine registrierungsfertige Geschäftsidentität. Beziehen Sie aktuelle Werte für entityType, vertical, country, state, brandRelationship und andere Aufzählungen aus den Messaging-Katalogen.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

Unternehmens- und Kontaktfelder

Einzelunternehmer werden für Registrierungen in den USA oder Kanada unterstützt und benötigen vor der Kampagnenberechtigung eine OTP-Verifizierung. Börsennotierte Unternehmen können einen Validierungsschritt über den Geschäftskontakt erfordern. GOVERNMENT ist für in den USA ansässige Regierungsstellen vorgesehen; bestätigen Sie für andere Organisationen die richtige Entitätskategorie. Befolgen Sie die entitätsspezifischen Anforderungen sowie die zurückgegebenen Validierungsfehler.

Behalten Sie einen stabilen Idempotenzschlüssel bei

Erzeugen Sie einen Idempotency-Key für diese beabsichtigte Registrierung. Er muss 1–128 druckbare ASCII-Zeichen ohne Leerzeichen enthalten. Verwenden Sie denselben Schlüssel nur mit derselben HTTP-Methode, demselben Pfad, derselben Query-Zeichenkette und exakt denselben Bytes des Anfragetexts wieder. Eine Neuformatierung des JSON ändert den Fingerabdruck der Anfrage, selbst wenn sich seine Bedeutung nicht ändert.

Eine abgeschlossene Anfrage mit Schlüssel kann ihre gespeicherte Antwort erneut ausliefern, ohne dass eine weitere Registrierung eingereicht wird. Ein Duplikat, das noch verarbeitet wird, gibt HTTP 409 zurück und kann Retry-After enthalten. Eine geänderte Anfrage mit demselben Schlüssel führt zu einem Konflikt. Erzeugen Sie keinen neuen Schlüssel, nur weil eine Anfrage in eine Zeitüberschreitung gelaufen ist oder einen Fehler zurückgegeben hat: Das Unternehmen ist möglicherweise bereits registriert.

Lassen Sie brand.json unverändert, während Sie diese Anfrage klären. Ein zwischengespeicherter 500 oder 502 kann den ursprünglichen Fehler erneut ausliefern, statt die Registrierung zu wiederholen. Bewahren Sie jedes zurückgegebene brandId, requestId und die Korrelations-Header auf; gleichen Sie die bestehende Marke ab, bevor Sie eine andere Anfrage starten.

Lesen Sie die Marke und ihren Status

Diese API verwendet HTTP-Statuscodes und einen direkten JSON-Body statt der v3-Hülle aus status/response. Eine erfolgreiche Registrierung gibt ein Markenobjekt zurück, das brandId enthält. Speichern Sie diese Kennung und prüfen Sie den zurückgegebenen Validierungs- oder Identitätsstatus. Zusätzliche Felder hängen von der Entität und dem Registrierungszustand ab.

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

Lesen Sie nur eine Marke, die zu Ihrem Konto gehört. Ein 404 kann bedeuten, dass die Marke für dieses Konto nicht verfügbar ist. Schließen Sie jede erforderliche Validierung ab und verwenden Sie dann die Markenqualifizierung zum Auffinden ihrer verfügbaren Kampagnen-Anwendungsfälle. Mock-Ressourcen können nicht als für den Produktionsversand berechtigt angesehen werden.

Produktionsgebühren

Diese Endkundenbeträge wurden am 24. Oktober 2026 mit der aktuellen Portalkonfiguration abgeglichen. Bestätigen Sie die aktuelle Gebühr im Portal vor der Produktionsregistrierung. Kampagnengebühren, zusätzliche Überprüfung und Messaging-Nutzung sind davon getrennt. Eine Produktionsregistrierung prüft vor der Einreichung die Kaufberechtigung und das verfügbare Guthaben; die erfolgreiche Anlage im Register und die lokale Abrechnung sind getrennte Verarbeitungsschritte, bewahren Sie daher die Ressourcen-ID auf und gleichen Sie die Transaktionen ab, falls ein Fehler oder ein Abrechnungsproblem auftritt.

Die Umstellung einer Mock-Marke auf Produktion ist ein separat bestätigter Workflow und kann eine neue Produktionsidentität und eine Abbuchung erzeugen. Gehen Sie nicht davon aus, dass das Ändern von mock auf false in einer späteren Anfrage die bestehende Marke umwandelt.

Fehler behandeln, ohne die Marke zu duplizieren