資料請求

Infobip には、リソースを要求し、状態に関する情報を提供し、要求の進行状況を指定するための効率的な方法がいくつか用意されています。

リクエスト手順は、地域の規制への準拠を保証し、ブランドの可視性を高め、メッセージの配信可能性を向上させます。

規制とコンプライアンス: 多くのリソースでは、国レベルのコンプライアンスに基づいて、使用前に国固有の承認と文書化が必要です
ブランディングと認識:カスタム送信者IDと番号は、企業がプロフェッショナルなイメージを維持するのに役立ちます
チャネル固有の要件: 各チャネルには、送信者 ID に関する異なるルールがあります

リソース API API と Web インターフェイスのどちらを使用している場合でも、リソースを要求する手順は同じ大まかな手順に従います。

リソースを要求するための大まかな手順

大まかな手順に従って、リソースを要求します。

データ収集要件: 要求に関連するすべての情報を収集します。一部のリソースでは、登録または追加データの提供が必要です。これらはデータ要件として知られています。
要求の送信: 任意の方法を使用して要求を送信します。Infobip が要求を受信すると、要求の特定の要件に対してデータが検証されます。
フィードバックの受信: 次のいずれかの方法でフィードバックを受け取ります。
- Infobip チームは電子メールで連絡し、特にデータが欠落していたり不正確であったりする場合に、リクエストのステータスに関するフィードバックを共有します。
- 英数字の送信者要求と番号購入の場合、システムは最初に自動検証フィードバックを提供します。要求が検証に合格すると、内部レビューに進みます。このレビューからのフィードバックは、API を介して、マイリクエストです。
フィードバックに応答する: データ要件を満たすように要求を更新します。次のいずれかの方法を使用して要求を更新します。
- Infobip チームに電子メールを送信して、要求の更新データまたは修正を提供します
- 英数字の送信者と購入番号の場合は、over API または Web インターフェイス Requesting resources over web interface でリクエストのデータを更新するか、リクエストキャンセルすることを選択できます
処理: Infobip は登録/または調達を進めます。
完了: リクエストが完了しました。

次の表に、サポートされている要求の状態を示します。

申請状況	説明
保留中	要求は Infobip によって処理されています。このフェーズでは、Infobip チームは、追加のデータまたはデータの更新について電子メールで連絡する場合があります。
却下	要求は Infobip によって取り消されました。
完了しました	要求が完了しました。

API を介したリソースの要求

リソース要求 API では、次の要求の種類がサポートされています。

英数字登録
番号購入
選択したリソースの種類によっては、追加のパラメーターが必要です。

API を介してリソースを要求するプロセスでは、リソース要求エンドポイント (opens in a new tab) を次の順序で使用します。

リソースの要件の一覧を取得します (要件の取得エンドポイント (opens in a new tab))。
リソース要求をサポートするために必要なドキュメントをアップロードします (ドキュメントのアップロードエンドポイント (opens in a new tab))。
リソースの要求を送信します (リソース要求エンドポイントの送信 (opens in a new tab))。
要求の送信の状態に関する更新通知を受信します (リソース要求の状態更新の受信 Webhook (opens in a new tab))。
英数字の送信者要求の場合: 必要な追加データを含む英数字の送信者要求の更新リソース要求エンドポイントの更新 (opens in a new tab)
英数字の送信者要求の場合: 英数字の送信者要求を続行したくない場合は、要求をキャンセルできますリソース要求エンドポイントのキャンセル (opens in a new tab)

手記

英数字の送信者に対する更新とキャンセルの要求は、選択したアカウントでのみ使用できます。この機能の使用を開始するには、サポート (opens in a new tab) または Infobip アカウントマネージャーにお問い合わせください。

リソースを要求すると、要求ステータスが表示されるため、アクションを実行する必要があるタイミングがわかります。

次の表は、API 経由でリソースを要求するときにサポートされる可能性のある状態を示しています。

API ステータス	説明
「保留中」	要求は Infobip によって処理されています。このフェーズでは、Infobip チームは、追加のデータまたはデータの更新について電子メールで連絡する場合があります。
`AUTOMATIC_VALIDATION`	このステータスは、英数字の送信者要求 (`ALPHANUMERIC_REGISTRATION`) と番号購入 (`NUMBER_PURCHASE`) の両方に適用されます。要求は現在、提供された要件データの自動検証中です。このプロセスでは、データ形式が最大および最小の長さまたは値の制限を満たしていることを確認し、すべての必須フィールドが存在することを確認し、正規表現に準拠していることを確認します。
`UPDATE_REQUESTED`	このステータスは、英数字の送信者要求 (`ALPHANUMERIC_REGISTRATION`) と番号購入 (`NUMBER_PURCHASE`) の両方に適用されます。自動検証により、提供された要件データに関する問題が特定されたため、要求を更新する必要があります。検証フィードバックは、オブジェクトの `requirementsFeedback` 配列の Get リソース要求から返されます。
「却下」	Infobip は要求を拒否しました。
「キャンセル済み」	このステータスは、英数字の送信者要求 (`ALPHANUMERIC_REGISTRATION`) と番号購入 (`NUMBER_PURCHASE`) の両方に適用されます。要求は取り消されました。
「完了」	要求が完了しました。

要件の取得

要件の取得 (opens in a new tab)エンドポイントを使用して、特定の要求の種類に関連するすべての要件の一覧を取得します。要求では、リソースの種類 (番号または英数字の送信者) と関連する必須パラメーターを指定します。例えば：

ALPHANUMERIC_REGISTRATION - 2 文字の国コードを指定します。
NUMBER_PURCHASE - 国コード、番号の種類 (SHORT_CODE、VIRTUAL_LONG_NUMBER、TEN_DIGIT_LONG_CODE、TOLL_FREE_NUMBER) と機能 (SMS、VOICE、MMS) を指定します。

API は、指定されたリソースを要求するときに指定する必要がある必須データフィールドの一覧を返します。リソースの種類は、'テキスト'、'整数'、'電子メール'、URL、GSM、および 'ドキュメント' です。

要求は検証され、構文、承認、およびアクセス許可がチェックされ、違反を示すエラーが返されます。必須フィールドが欠落している場合、要求は拒否されるか、追加の入力が必要です。さらに、TEXT と INTEGER では、次の検証規則を指定できます。

TEXT - 文字列の最小長、最大長、およびパターン
INTEGER - 最小値と最大値

次の表は、このエンドポイントに対する潜在的な応答を示しています。

レスポンス	リソース	お問合せ
要件は必要ありません	数値	空のオブジェクトが返された場合、その番号は、要求を続行するために追加のドキュメントやデータを必要としません。
オファーなし	数値	この番号には、利用可能な適切なオファーがありません。次のエラーコードが `RES-NUM-LOOKUP404` が返されます。
登録なし	英数字の送信者	現在、英数字の登録は受け付けておりません。これは、国が任意の送信者の使用を許可しているか、英数字の送信者が全体的にサポートされていないことが原因である可能性があります。詳細については、「SMS カバレッジと接続性を参照してください。

次に、この情報を使用して、要求を送信する前に必要なデータを収集します。

書類のアップロード

ドキュメントのアップロード (opens in a new tab) エンドポイントを使用してドキュメントをアップロードし、リソース要求内の要件として使用できるようにします。

このエンドポイントは、いずれかの要件がタイプDOCUMENTの場合にのみ使用します。

このエンドポイントは応答で ID を返し、その ID は API 要求と共に送信されます。

リソース要求の送信

[リソース要求の送信] エンドポイント (opens in a new tab)を使用して、有効な要件データを含む要求を送信します。特定の番号または英数字の送信者の課金に応じて、要求に対して課金される場合があります。

Note

一部の数値は、追加のデータを必要としません。必要なすべてのデータに対して [ 要件の取得 (opens in a new tab) ] を使用します。

10DLC (番号タイプ TEN_DIGIT_LONG_CODE) の場合、特定の状態に属する番号、または特定の npa または nxx を持つ番号を使用する場合は、要件オブジェクト内で状態、npa、または nxx に関する情報を指定できます。

更新の受信 Webhook

リソース要求の状態に対する変更は、 [リソース要求の状態の更新の受信] Webhook (opens in a new tab) を使用して通知できます。

ステータスに変更がある場合、Webhook はリクエストのステータスを指定するイベントを返します。たとえば、COMPLETEDやREJECTEDなどです。

リソース要求の更新

英数字の送信者 (ALPHANUMERIC_REGISTRATION) または番号の購入 (NUMBER_PURCHASE) 要求を送信すると、自動検証によって、指定された要件データに関する問題が検出される場合があります。検証の問題は、 Get リソース要求 (opens in a new tab)のオブジェクトの requirementsFeedback 配列で返されます。

英数字の送信者 (ALPHANUMERIC_REGISTRATION) または購入番号 (NUMBER_PURCHASE) 要求が UPDATE_REQUESTED または UPDATE_REQUESTED_BY_INTERNAL_REVIEWER 状態の場合、リソースの更新要求エンドポイント (opens in a new tab) と要求識別子を使用して要求を更新できます。

または、 Infobip サポート (opens in a new tab) に電子メールを送信して、変更を説明し、更新されたデータを提供することで、要求を更新することもできます。その後、Infobip サポートチームから連絡があり、追加データを取得します。

リソース要求のキャンセル

英数字の送信者 (ALPHANUMERIC_REGISTRATION) または購入番号 (NUMBER_PURCHASE) 要求が UPDATE_REQUESTED 状態の場合、リソース要求のキャンセルエンドポイント (opens in a new tab) と要求識別子を使用して、キャンセルに要求を送信できます。API 経由で既存の要求を取り消すと、Infobip で要求がキャンセルされます。

Infobip サポート (opens in a new tab)にメールを送信して、リクエストをキャンセルすることもできます。Infobipチームは、先に進んでリクエストをキャンセルしたいことを確認するためにあなたに連絡する場合があります。

Web インターフェースを介したリソースの要求

Infobip Web インターフェイス (opens in a new tab)の チャネルと番号 からリソースを要求できます。Infobip アカウントを使用してログインし、[チャネルと番号] に移動して、[チャネル]、[番号]、または [マイリクエスト]** を選択します。

たとえば、次のことができます。

Numbersから番号を購入する
Channels > SMS から英数字の送信者をリクエストする
マイリクエストからチャネルまたは送信者を要求する

リソースを要求すると、要求ステータスが表示されるため、アクションを実行する必要があるタイミングがわかります。

次の表は、Web インターフェイスを介してリソースを要求するときにサポートされる可能性のあるステータスを示しています。

申請状況	ステータスアイコンの色	説明
保留中	イエロー	要求は Infobip によって処理されています。このフェーズでは、Infobip チームは、追加のデータまたはデータの更新について電子メールで連絡する場合があります。
必要な対応	レッド	自動検証により、提供された要件データに関する問題が特定されたため、要求を更新する必要があります。要求がこの状態の場合、キャンセルするオプションがあります。
却下	レッド	要求は Infobip によって拒否されました。
キャンセル	グレー	要求は取り消されました。
完了	グリーン	要求が完了しました。

手記

英数字の送信者または番号の購入に対する更新とキャンセルのリクエストは、選択したアカウントでのみ使用できます。この機能の使用を開始するには、サポート (opens in a new tab) または Infobip アカウントマネージャーにお問い合わせください。

Numbersから番号を購入する

チャンネルと数字の数字から番号を購入するには:

チャンネルと数字 > 数字に移動します。
Buy Number をクリックします。
詳細については、番号の購入を参照してください。

SMS に英数字の送信者を要求する

「チャンネルと番号」のSMSに英数字の送信者を要求するには:

チャンネルと番号 > チャンネル >SMS**に移動します。
英数字の送信者 ID で、[送信者の要求] をクリックします。
詳細については、MyRequests の送信を参照してください。

[マイリクエスト] からの要求チャネル

チャネルと番号 の 自分の要求 からチャネルまたは送信者を要求するには:

[チャンネルと番号] > [マイリクエスト] に移動します。
[要求チャネル] をクリックします。
詳細については、MyRequests の送信を参照してください。

概要リソースの管理