Rejestracja marki wiadomości

Zarejestruj firmę stojącą za Twoimi wiadomościami

Marka wiadomości identyfikuje firmę wysyłającą wiadomości 10DLC w USA. Zarejestruj markę przed wyborem przypadku użycia kampanii. Użyj danych prawnych firmy oraz osoby kontaktowej, która może ukończyć wymaganą walidację. Zwrócony identyfikator marki nie jest sam w sobie zgodą na wysyłanie wiadomości.

Używaj tej bieżącej trasy należącej do konta przez HTTPS z włączonym kontem API i jego dozwolonym źródłowym adresem IP. Nie przesyłaj user_id, username ani identyfikatora właściciela innego klienta. MultiTEL zapisuje własność na podstawie uwierzytelnionego konta.

Zacznij od jawnego żądania piaskownicy

Portal domyślnie ustawia pole mode formularza na tryb piaskownicy; bezpośrednie żądanie API musi jawnie zawierać wartość logiczną JSON mock: true, gdy zamierzasz utworzyć markę testową. Pominięcie tej flagi nie gwarantuje piaskownicy i może utworzyć płatną rejestrację produkcyjną. Pole mode portalu nie zastępuje pola mock interfejsu API.

Przygotuj lokalny plik brand.json z użyciem poniższych pól. Zastąp symbole zastępcze odpowiednimi danymi testowymi i aktualnymi kodami z katalogów. Ten przykład dotyczy prywatnej firmy nastawionej na zysk; inne typy podmiotów mają inne wymagania.

{
  "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
}

Powyższa firma, adres, telefon i identyfikator to symbole zastępcze, a nie tożsamość firmy gotowa do rejestracji. Aktualne wartości entityType, vertical, country, state, brandRelationship i innych wyliczeń pobierz z katalogów wiadomości.

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'

Pola firmy i kontaktu

Jednoosobowe działalności są obsługiwane dla rejestracji w USA lub Kanadzie i wymagają weryfikacji OTP przed uzyskaniem kwalifikacji do kampanii. Spółki publiczne mogą wymagać kroku walidacji firmowego kontaktu. GOVERNMENT jest przeznaczone dla podmiotów rządowych z siedzibą w USA; w przypadku innych organizacji potwierdź właściwą kategorię podmiotu. Przestrzegaj wymagań dla danego typu podmiotu oraz zwróconych błędów walidacji.

Zachowaj stabilny klucz idempotencji

Wygeneruj jeden Idempotency-Key dla tej zamierzonej rejestracji. Musi on zawierać 1–128 drukowalnych znaków ASCII bez spacji. Używaj ponownie tego samego klucza tylko z tą samą metodą HTTP, ścieżką, ciągiem zapytania i dokładnie tymi samymi bajtami treści żądania. Zmiana formatowania JSON, nawet bez zmiany jego znaczenia, zmienia odcisk żądania.

Zakończone żądanie z kluczem może odtworzyć zapisaną odpowiedź bez ponownego przesyłania rejestracji. Duplikat, który wciąż jest przetwarzany, zwraca HTTP 409 i może zawierać Retry-After. Zmienione żądanie z tym samym kluczem powoduje konflikt. Nie generuj nowego klucza tylko dlatego, że żądanie przekroczyło limit czasu lub zwróciło błąd: firma mogła już zostać zarejestrowana.

Nie zmieniaj pliku brand.json podczas rozwiązywania tego żądania. Zbuforowany błąd 500 lub 502 może odtworzyć pierwotny błąd zamiast ponowić rejestrację. Zachowaj wszelkie zwrócone brandId, requestId i nagłówki korelacji; sprawdź rzeczywisty stan istniejącej marki i wyjaśnij ewentualne rozbieżności przed rozpoczęciem innego żądania.

Odczytaj markę i jej status

To API używa kodów statusu HTTP i bezpośredniej treści JSON, a nie koperty status/response z wersji v3. Pomyślna rejestracja zwraca obiekt marki zawierający brandId. Zapisz ten identyfikator i sprawdź zwrócony status walidacji lub tożsamości. Dodatkowe pola zależą od podmiotu i stanu rejestracji.

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

Odczytuj tylko markę należącą do Twojego konta. Kod 404 może oznaczać, że marka nie jest dostępna dla tego konta. Ukończ wymaganą walidację, a następnie użyj kwalifikacji marki w celu znalezienia dostępnych dla niej przypadków użycia kampanii. Zasobów testowych nie można uznawać za kwalifikujące się do wysyłki produkcyjnej.

Opłaty produkcyjne

Te kwoty detaliczne sprawdzono względem aktualnej konfiguracji portalu w dniu 24 października 2026. Przed rejestracją produkcyjną potwierdź aktualną opłatę w portalu. Opłaty za kampanie, dodatkowa weryfikacja i zużycie wiadomości są rozliczane osobno. Rejestracja produkcyjna sprawdza uprawnienie do zakupu i dostępne środki przed przesłaniem; pomyślne utworzenie w rejestrze i lokalne rozliczenie to osobne etapy przetwarzania, dlatego zachowaj identyfikator zasobu i uzgodnij transakcje w razie błędu lub problemu z rozliczeniem.

Zmiana marki testowej na produkcyjną to osobno potwierdzany przepływ, który może utworzyć nową tożsamość produkcyjną i obciążenie. Nie zakładaj, że zmiana mock na false w późniejszym żądaniu przekształci istniejącą markę.

Obsługuj błędy bez duplikowania marki