資料請求

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

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

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

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

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

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

データ収集要件: 要求に関連するすべての情報を収集します。一部のリソースでは、登録または追加データの提供が必要です。これらはデータ要件として知られています。
要求の送信: 任意の方法を使用して要求を送信します。Infobip が要求を受信すると、要求の特定の要件に対してデータが検証されます。
フィードバックの受信: 次のいずれかの方法でフィードバックを受け取ります。
- Infobip チームは電子メールで連絡し、特にデータが欠落していたり不正確であったりする場合に、リクエストのステータスに関するフィードバックを共有します。
- 英数字の送信者要求と番号購入の場合、システムは最初に自動検証フィードバックを提供します。要求が検証に合格すると、内部レビューに進みます。このレビューからのフィードバックは、API を介して、マイリクエストです。
フィードバックに応答する: データ要件を満たすように要求を更新します。次のいずれかの方法を使用して要求を更新します。
- リクエストのステータスが アクションが必要 の場合は、マイリクエスト ページからリクエストの編集 (アルファ送信者リクエストの場合のみ) できます。これにより、要求された追加の詳細を送信できます。
- 現在の要求の状態に応じて、要求のデータを API 経由更新します。
- Supportにメールを送信して、リクエストの更新データまたは修正を提供してください。
処理: 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)を使用して要求をキャンセルできます。

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

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

ステータス	説明
「保留中」	要求は Infobip によって処理されています。このフェーズでは、Infobip チームは追加のデータや更新について電子メールで連絡する場合があります。
`UPDATE_REQUESTED_BY_INTERNAL_REVIEWER`	Infobip レビュー担当者は、リソース要求に対する追加情報または修正を要求しました。必要な更新が送信されるまで、要求を続行できません。検証フィードバックは、 Get resource requests (opens in a new tab) 呼び出しの `requirementsFeedback` 配列を介して提供されます。
`AUTOMATIC_VALIDATION`	要求は自動検証を受けており、データ形式、フィールド要件、値の制限、および正規表現への準拠がチェックされています。
`UPDATE_REQUESTED`	このステータスは、英数字の送信者要求と番号購入の両方に適用されます。自動検証により、送信されたデータに問題が検出されたため、要求者は情報を更新する必要があります。検証フィードバックは、 Get resource requests (opens in a new tab) 呼び出しの `requirementsFeedback` 配列を介して提供されます。
「却下」	Infobip は要求を拒否しました。
「キャンセル済み」	このステータスは、英数字の送信者要求と番号購入の両方に適用されます。要求は、依頼者またはシステムによって取り消されました。
「完了」	要求は正常に処理され、確定されました。
`PENDING_REVIEW`	要求は、送信後に Infobip によるレビューを待っています。このステップは、自動検証または手動評価の前に行われます。
`IN_REVIEW`	要求は、詳細、コンプライアンス、および完全性を確認するために、Infobip チームメンバーによって積極的にレビューされています。
`IN_PROGRESS`	要求は Infobip によって内部的に処理されていますが、初期検証に合格しています。承認、割り当て、プロビジョニングなど、その他のアクションが進行中です。

要件の取得

要件の取得 (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) 要求を送信すると、Infobip 登録チームによるレビュープロセスと自動検証によって、提供された要件データに関する問題が検出される場合があります。検証の問題は、 Get resource requests (opens in a new tab) エンドポイントからのオブジェクトの requirementsFeedback 配列で返されます。

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

または、リクエストのステータスが アクションが必要 の場合は、マイリクエスト ページまたは Numbers App で番号購入リクエストのリクエストを編集 (アルファ送信者リクエストの場合のみ) できます。これにより、要求された追加の詳細を送信できます。

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

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

さらに、英数字の送信者または番号購入リクエストのどちらであるかに応じて、Webインターフェイスを介してリクエストをキャンセルできます。

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

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

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

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

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

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

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

手記

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

Numbersから番号を購入する

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

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

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

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

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

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

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

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

概要リソースの管理