title: “チケット内に外部情報を表示する”

バージョン4.25.6.4以降、LiveAgentには「Display external info in a ticket」という便利な新しいプラグインが搭載されました。これにより、エージェントがチケットを開いたときに外部サーバーやアプリケーションからデータを読み込むことができるようになります。接続を構築するための開発スキットさえあれば、このプラグインはエージェントが外部システムの情報を確認するための非常に有用なツールとなります。

例えば、エージェントが現在対応している顧客の最新注文を一覧表示するために、EコマースシステムのAPIを呼び出す用途に使うことができます。これにより、エージェントはLiveAgentのバックエンド上で、顧客がショップで何を注文したかを直接確認できるようになります。このプラグインの可能性は非常に広く、エージェントにとって不要なクリックを大幅に削減できます。

このプラグインは、LiveAgentの管理パネルのConfiguration（設定）-> Integrations（連携）セクションから有効化・設定できます。「Display external info on the ticket」の横にある「Activate」（有効化）をクリックしてください。プラグインを有効化してアプリケーションを再読み込みしたら、再びPlugins（プラグイン）セクションに戻り、「Display external info in the ticket」の横にある「Configure」（設定）ボタンをクリックして、実際にプラグインの設定を行います。

このプラグインは基本的に、指定したURLの内容をiframe経由で読み込み、アプリケーション内のチケットサイドバーにある**「雲」アイコン**の下、チケットセクション内に表示します。

プラグインを設定すると、いくつかのオプションを含むフィールドが表示されます。

各フィールドとオプションの内容を説明します。

**The display method（表示方法）**は、スクリプトの内容をエージェントにどのように表示するかを選択するためのもので、2つのオプションがあります。

  • Proxy request through LiveAgent（LiveAgent経由でリクエストをプロキシする） - プロキシ方式を選択すると、スクリプトはLiveAgentサーバー経由で読み込まれ、実際のコンテンツのみがエージェントに表示されます。そのため、エージェントはコンテンツを表示しているスクリプトのURLを取得することができません。
  • Load directly into agent’s browser（エージェントのブラウザに直接読み込む） - エージェントがスクリプトのURLを取得できても問題ない場合は、こちらのオプションを簡単に利用できます。

URLフィールドには、エージェントがチケットを開いてCustom pluginのセクションに移動した際に呼び出されるカスタムスクリプトのURLアドレスを入力します。必要に応じて変数を使ってURLを組み立てることができます。例：

https://mydomain.com/info.php?customer={$contact_email}&customer_phone={$contact_phone}

**HTTP Method（HTTPメソッド）**は、指定したURLアドレスへのHTTPリクエストをGETメソッドとPOSTメソッドのどちらで送信するかを決定します。

**Request body（リクエストボディ）**フィールドは、HTTPリクエストメソッドとしてPOSTを選択した場合にのみ使用され、POSTリクエストを組み立てる際に、カスタムスクリプトで使用したいLiveAgentの変数を含めることができます。例：

ticket={$conv_conversationid}&subject={$conv_subject}

HTTPメソッドとしてGETを選択した場合は、上記の例のように変数を通常のGETパラメータとしてURLに含めます。

**HTTP Authentication user and password（HTTP認証ユーザーとパスワード）**は、スクリプトが.htaccessによるHTTP認証で保護されている場合に使用します。これにより、コンテンツを表示する際にアプリケーションが認証を行えるようになります。