メッセージングブランドを登録する

メッセージの背後にある事業者を登録する

メッセージングブランドは、米国向け10DLCメッセージを送信する事業者を識別します。キャンペーンのユースケースを選択する前にブランドを登録してください。事業者の正式な情報と、必要な検証を完了できる連絡先を使用してください。返されたブランドIDは、それだけではメッセージ送信の承認を意味しません。

有効なAPIアカウントと許可された送信元IPアドレスを使用して、HTTPS経由で現行のアカウント所有型ルートを使用してください。user_id、username、または他の顧客の所有者識別子を送信しないでください。MultiTELは認証済みアカウントから所有権を記録します。

明示的なサンドボックスリクエストから始める

ポータルのフォームでは、modeフィールドが既定でサンドボックスに設定されています。モックブランドを意図する場合は、直接のAPIリクエストにJSON真偽値mock: trueを明示的に含める必要があります。このフラグを省略してもサンドボックスは保証されず、課金対象の本番登録が作成される可能性があります。ポータルのmodeフィールドは、APIのmockフィールドの代わりにはなりません。

以下のフィールドを使用してローカルの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'

事業者情報と連絡先のフィールド

個人事業主は米国またはカナダの登録でサポートされ、キャンペーン対象となる前にOTP検証が必要です。上場会社では事業者連絡先の検証手順が必要になる場合があります。GOVERNMENTは米国所在の政府機関向けです。その他の法人については正しい事業体区分を確認してください。事業体種別ごとの要件と、返された検証エラーの両方に従ってください。

安定したべき等性キーを維持する

この登録意図に対してIdempotency-Keyを一つ生成してください。キーはスペースを含まない1–128文字の印字可能なASCII文字で構成する必要があります。同じキーは、同じHTTPメソッド、パス、クエリ文字列、および正確に同一のリクエストボディバイトとの組み合わせでのみ再利用してください。意味を変更しないJSONの再整形であっても、リクエストのフィンガープリントは変わります。

完了済みのキー付きリクエストは、登録を再送信することなく保存された応答を再生できます。処理中の重複リクエストはHTTP 409を返し、Retry-Afterを含む場合があります。同じキーでリクエスト内容を変更すると競合します。リクエストがタイムアウトした、またはエラーを返したという理由だけで新しいキーを生成しないでください。事業者が既に登録されている可能性があります。

そのリクエストを解決する間はbrand.jsonを変更しないでください。キャッシュされた500または502は、登録を再試行するのではなく元のエラーを再生する場合があります。返されたbrandId、requestId、相関ヘッダーを保持し、別のリクエストを開始する前に既存のブランドの実際の状態を確認し、不整合があれば解消してください。

ブランドとそのステータスを読み取る

このAPIは、v3のstatus/responseエンベロープではなく、HTTPステータスコードと直接のJSONボディを使用します。登録に成功するとbrandIdを含むブランドオブジェクトが返されます。その識別子を保存し、返された検証ステータスまたはアイデンティティステータスを確認してください。追加フィールドは事業体と登録状態によって異なります。

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

ご自身のアカウントに属するブランドのみを読み取ってください。404は、そのブランドがこのアカウントでは利用できないことを意味する場合があります。必要な検証を完了してから、ブランド認定を使って、利用可能なキャンペーンのユースケースを確認してください。モックリソースが本番送信に利用可能であると想定しないでください。

本番料金

これらの小売金額は十月24日（2026年）時点の現行ポータル設定と照合されています。本番登録の前にポータルで現行料金を確認してください。キャンペーン料金、追加審査、メッセージ利用料は別途です。本番登録では送信前に購入権限と利用可能な資金を確認します。レジストリ内でのブランド作成の成功とローカル課金は別々の処理手順であるため、エラーや課金問題が発生した場合はリソースIDを保持し、取引を突き合わせてください。

モックブランドから本番への変更は別途確認が必要なワークフローであり、新しい本番アイデンティティと課金が発生する場合があります。後のリクエストでmockをfalseに編集すれば既存のブランドが変換されると想定しないでください。

ブランドを重複させずにエラーを処理する