Зареєструйте бренд для обміну повідомленнями

Зареєструйте бізнес, що стоїть за вашими повідомленнями

Бренд повідомлень ідентифікує компанію, яка надсилає повідомлення US 10DLC. Зареєструйте бренд, перш ніж обирати варіант використання кампанії. Використовуйте юридичні дані компанії та контактну особу, яка зможе пройти потрібну перевірку. Повернутий ідентифікатор бренда сам по собі не є дозволом на надсилання повідомлень.

Використовуйте цей актуальний маршрут, що належить обліковому запису, через HTTPS з увімкненим обліковим записом API та його дозволеною IP-адресою джерела. Не надсилайте user_id, username або інший ідентифікатор власника іншого клієнта. MultiTEL фіксує власність за автентифікованим обліковим записом.

Почніть із явного запиту до пісочниці

У формі порталу поле mode за замовчуванням установлено в режим пісочниці; прямий запит API має явно містити логічне значення JSON mock: true, якщо ви маєте намір створити тестовий бренд. Пропуск цього прапорця не гарантує пісочницю та може створити оплатну бойову реєстрацію. Поле mode порталу не замінює поле mock API.

Підготуйте локальний файл brand.json, використовуючи поля нижче. Замініть заповнювачі відповідними тестовими даними й актуальними кодами з каталогів. У цьому прикладі — приватний прибутковий бізнес; інші типи сутностей мають інші вимоги.

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

Наведені вище компанія, адреса, телефон та ідентифікатор є заповнювачами, а не готовою до реєстрації бізнес-ідентичністю. Актуальні значення для entityType, vertical, country, state, brandRelationship та інших переліків дивіться в каталогах повідомлень.

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'

Поля бізнесу та контактів

Одноосібні підприємці підтримуються для реєстрацій US або Канади та потребують OTP-перевірки перед отриманням права на кампанії. Публічні компанії можуть потребувати етапу перевірки бізнес-контакту. GOVERNMENT призначено для урядових структур, розташованих у US; для інших організацій підтверджуйте правильну категорію сутності. Дотримуйтеся вимог для конкретної сутності, а також повернутих помилок перевірки.

Зберігайте стабільний ключ ідемпотентності

Створіть один Idempotency-Key для цієї навмисної реєстрації. Він має містити 1–128 друкованих символів ASCII без пробілів. Повторно використовуйте той самий ключ лише з тим самим методом HTTP, шляхом, рядком запиту й точними байтами тіла запиту. Переформатування JSON, навіть без зміни його значення, змінює відбиток запиту.

Завершений запит із ключем може повторно відтворити збережену відповідь без повторного надсилання реєстрації. Дублікат, що ще обробляється, повертає HTTP 409 і може містити Retry-After. Змінений запит із тим самим ключем спричиняє конфлікт. Не створюйте новий ключ лише тому, що запит перевищив час очікування або повернув помилку: бізнес, можливо, уже зареєстровано.

Не змінюйте brand.json під час вирішення цього запиту. Кешована помилка 500 або 502 може повторно відтворити вихідну помилку замість повторної спроби реєстрації. Зберігайте будь-які повернуті brandId, requestId та заголовки кореляції; звірте фактичний стан наявного бренду й усуньте розбіжності, перш ніж починати інший запит.

Прочитайте бренд та його статус

Цей API використовує коди стану HTTP і пряме тіло JSON замість обгортки v3 status/response. Успішна реєстрація повертає об’єкт бренда, включно з brandId. Збережіть цей ідентифікатор і перевірте повернутий статус перевірки або ідентичності. Додаткові поля залежать від сутності та стану реєстрації.

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

Читайте лише бренд, що належить вашому обліковому запису. Помилка 404 може означати, що бренд недоступний для цього облікового запису. Завершіть усі потрібні перевірки, а потім скористайтеся кваліфікацією бренду, щоб знайти доступні варіанти використання кампаній. Не можна вважати тестові ресурси придатними для бойового надсилання.

Тарифи бойового використання

Ці роздрібні суми звірено з актуальною конфігурацією порталу станом на 24 жовтня 2026 року. Підтвердіть актуальний тариф на порталі перед бойовою реєстрацією. Плата за кампанії, додаткова перевірка та використання обміну повідомленнями оплачуються окремо. Бойова реєстрація перевіряє дозвіл на купівлю та наявне фінансування перед надсиланням; успішне створення в реєстрі та локальне виставлення рахунку — окремі етапи обробки, тому зберігайте ідентифікатор ресурсу й звіряйте транзакції й усувайте розбіжності, якщо сталася помилка або проблема з оплатою.

Переведення тестового бренду в бойовий режим — це окремо підтверджуваний сценарій, який може створити нову бойову ідентичність і списання коштів. Не припускайте, що редагування mock на false у пізнішому запиті перетворює наявний бренд.

Обробляйте помилки без дублювання бренду