埋め込み可能なMoments

埋め込み可能なMomentsは、プラットフォームユーザーのエクスペリエンスを簡素化しながら、完全に構成されたフローをデプロイできる事前定義されたユースケーステンプレートを提供します。iFrame を使用してソリューションを Web アプリケーションに統合し、ユーザーが次のことを行うことができます。

• ユース ケースのアクティブ化 は、ステップバイステップの構成ウィザードを使用します。
• アクティブ化されたユース ケースの管理 (パフォーマンス分析を含む)。

対応するMomentsフローは、専用のNTT CPaaSアカウントまたは分離されたXテナント内のバックグラウンドでシームレスに実行されます。

次の図は、埋め込みインターフェイスの例を示しています。

前提 条件

• アカウント管理ロールを持つ NTT CPaaS アカウント。

• 次の API スコープで APIキーを生成します。

  • アカウント管理:管理 - OAuth PAR フローを開始できるようにします。
  • フロー:管理
  • フロー:読み取り
  • フロー:使用

Xとの互換性 [#compatibility-with-x-moments]

埋め込み可能な Moments X の有無にかかわらず を使用できます。

プロセスの概要

1. 事前定義されたテンプレート(使用例)を持つキャンペーンウィザードの iFrame コンポーネントを使用します。

   Campaign ウィザードの iFrame コンポーネントを使用するには、リクエスト URI を指定 が必要です。この URI は、キャンペーンウィザード API にアクセスするために使用されます。

   この URI は、OAuth プッシュ権限付与要求 (PAR) と呼ばれるより安全な認証フローの一部としてバックエンドによって生成および挿入されます。

   大事な

   ユースケースを作成し、既存のユースケースを管理するには、NTT CPaaS アカウント マネージャーにお問い合わせください。

2. キャンペーンウィザードの iFrame コンポーネントの追加 を Web ページに追加します。

その後、顧客はフローをアクティブ化して使用できます。

要求 URI の生成 [#generate-request-uri]

Momentsでフロントエンドをレンダリングする前に、バックエンドで次のアクションに従ってください。

1. OAuth PAR フローを開始するには、次の URL に POST 要求を送信します。

   copy

   POST https://api.infobip.com/embeddable/1/auth/par

   次のヘッダーを使用します。

   javascript

   Copied!

   1'Content-Type': 'application/json',

   2'Authorization': 'App <api-key>'

   次のペイロードを使用します。

   json

   Copied!

   1{

   2 

   3 "embedding_id": <embedding_id>,

   4 "scopes": ['flow:manage', 'flow:read', 'flow:use'],

   5 "application_id": "<application_id>", // if needed

   6 "entity_id": "<entity_id>̣" // if needed

   7 

   8 "embedding\_id": , "scopes": \['flow:manage', 'flow:read', 'flow:use'\], "application\_id": "", // if needed "entity\_id": "̣" // if needed}

   cURL 要求は次のようになります。

   json

   Copied!

   1 

   2curl --location 'https://api.infobip.com/embeddable/1/auth/par' \ --header 'Authorization: App <api-key>' \ --header 'Content-Type: application/json' \ --data '{

   3"embedding_id": <embedding_id>,     "scopes": [ "flow:manage", "flow:read",

   4"flow:use" ],

   5"application_id": "<application_id>",

   6"entity_id": "<entity_id>" }'

2. 応答には、パラメータ request_uri を持つオブジェクトが含まれます。このパラメータは iFrame コンポーネントで使用します。

Web ページに iFrame コンポーネントを追加する [#add-iframe-to-web-page]

次の iFrame コンポーネントを Web ページに含めます。