Logo
Logo
CTRLK

共有コンポーネント

埋め込み可能なAnswers

早期アクセス

埋め込み可能なAnswersを使用すると、プラットフォームユーザーのエクスペリエンスを簡素化しながら、Answersの全範囲をデプロイできます。iFrame を使用して、ソリューションを Web アプリケーションに統合できます。

Answersの完全な経験

このオプションには、完全なチャットボットビルダーがあります。

前提 条件

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

  • APIキー の生成 を次の API スコープに置き換えます。

    • アカウント管理:管理 - OAuth PAR フローを開始できるようにします。
    • 回答:管理 - Answers を管理できるようにします。
    • voice-message:manage - ボイスボットを管理できるようにします。
  • X で Answers を使用する一環として、applicationId と entityId のペアを作成します

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

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

プロセスの概要

Answers iFrame コンポーネントを使用するには、request URI を指定する必要があります。この URI は、Answers API にアクセスするために使用されます。この URI は、OAuth プッシュ権限付与要求 (PAR) と呼ばれるより安全な認証フローの一部としてバックエンドによって生成および挿入されます。

次に、Answers iFrame コンポーネント を Web ページに追加する必要があります。

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

メモapplication_id and entity_id are optional request parameters.

Answersでフロントエンドをレンダリングする前に、バックエンドで次のアクションに従います。

  1. OAuth PAR フローを開始するには、次の URL に POST 要求を送信します。 POST https://api.infobip.com/embeddable/1/auth/par

    Use the following headers:

    json
    1'Content-Type': 'application/json'、
    2'権限付与': 'アプリ <api-key>'</api-key>

    Use the following payload:

    json
    1{
    2"scopes": ['answers:manage', 'voice-message:manage']、
    3"application_id": "<application_id>",</application_id>
    4"エンティティ ID": "<entity_id>"、</entity_id>
    5"embedding_id": "81d4b814-31ba-46aa-b842-8b07ee1221f6"
    6}

    The cURL request would be as follows:

    json
    1curl --location 'https://api.infobip.com/embeddable/1/auth/par' \
    2--ヘッダー '権限付与: アプリ <api-key>' \</api-key>
    3--header 'Content-Type: application/json' \
    4--data '{
    5"スコープ":[
    6 「回答:管理」、
    7 「ボイスメッセージ:管理」
    8],
    9"application_id": "<application_id>",</application_id>
    10"エンティティ ID": "<entity_id>"、</entity_id>
    11"embedding_id": "81d4b814-31ba-46aa-b842-8b07ee1221f6"
    12}'
  2. The response contains the object with request_uri parameter. Use this parameter in the iFrame component.

Add the iFrame component to your web page [#add-iframe-component-answers]

Include the following iFrame component on your web page:

json
<iframe src="https://embeddings.infobip.com/authorize?request_uri={request_uri}"></iframe>

Example

Refer to the Oracle Responsys integration.