Alli

Alli User Guide - Alli SDK実装（JavaScript）

本ガイドでは、Alliの実装に必要なJavascriptの実装について分かりやすく説明します。

Allganize Japan

• 5 min read
Alli User Guide - Alli SDK実装（JavaScript）

WEBサイトへの実装

Alli Javascriptの実装は次のコードをコピーしてWebサイトに貼り付けるだけです。

<head>
<script src="https://sdk.alli.ai/latest/alli.js"></script>
</head>

<body>
<!-- ...Your website content... -->

<!-- Start of Alli Code -->
<script>
  // YOUR_API_KEYにはAlli Dashboard > プロジェクト設定に記載の一意の値を入力します。 
  Alli.initialize({
    apiKey: "YOUR_API_KEY",
    debug: false, //これをオンにすると、デバッグ情報がコンソールに出力されます。
    backButton: true, //[オプション]デフォルト値は true。ヘッダーの戻るボタンを削除する場合は、このオプションをオフに設定します。
    providerLink: true, // [オプション]デフォルト値は true。Alliロゴのリンクを削除する場合は、このオプションをオフにします。
    styleOptions: { //[オプション]スタイルをカスタマイズします。
      conversationContainer: {
        right: 50, //画面右側からの間隔設定（チャット画面の位置が右に設定されている場合に適用)
        left: 50, //画面左側からの間隔設定（チャット画面の位置が左に設定されている場合に適用)
        bottom: 50 //画面下部からの間隔設定
      }
    }
  });
  if (window.Alli) {
    window.Alli.event();
  }
</script>
<!-- End of Alli Code -->
</body>

API_KEYはDashboard　設定＞全般タブのSDK キー より取得し、"YOUR_API_KEY"に入力します。

ブラウザをリフレッシュ後、Webサイトの右下にAlliのチャットダイアログポップアップが表示されたら、実装完了です。

SDKの初期化

コードをコピーして、ウェブページの<head>ブロックに貼り付けます。

<head>
<script src="https://sdk.alli.ai/latest/alli.js"></script>
</head>

<body>
<!-- ...Your website content... -->

<!-- Start of Alli Code -->
<script>
  if (window.Alli) {
    //apiKey is unique identifier provided by Alli 
    Alli.initialize({
      apiKey: "YOUR_API_KEY",
      debug: false,
      backButton: true
    });
  }
</script>
<!-- End of Alli Code -->
</body>

会話の開始

SDKを初期化したら、以下のオプションのいずれかを使用して次のコマンドを呼び出し、会話を開始してください。

if (window.Alli) {
    window.Alli.event();    
}

次の二つのオプションのいずれかを選択することができます。

１．ターゲティングおよびプレイスメントを指定しない場合

window.Alli.event();

２．ターゲティングとプレイスメントを指定する場合

window.Alli.event({
    user: {id: "YOUR_USER_ID"},
    placement: "YOUR_PLACEMENT"
});

プレイスメント情報は、Webページにロードするキャンペーンを識別するために使用されます。 Alliダッシュボード＞キャンペーン内で、各キャンペーンの配置を設定できます。

SDKの高度な設定

高度な設定については以下を参照してください。

Alli toggle icon の位置を調整する

メインのターゲットブラウザに応じて、Alli toggleボタンの位置を調整できます。

script内の以下コードの値を変更し位置を変更します。
StyleOptions> ConversationContainer> right、left、bottomの値を変更できます。
デフォルト値は５０となっています。

ドラッグアンドドロップでトグルアイコンが移動しないようにするには、disableToggleDragをtrueに設定します。

Alli.initialize({
  disableToggleDrag: false, // optional, default: false 
  styleOptions: { //[オプション]スタイルをカスタマイズします。
    conversationContainer: {
      right: 50, //画面右側からの間隔設定（チャット画面の位置が右に設定されている場合に適用)
      left: 50, //画面左側からの間隔設定（チャット画面の位置が左に設定されている場合に適用)
      bottom: 50 //画面下部からの間隔設定
    }
  }
});

トグルアイコンとプレビューなしで全画面でAlliウィンドウをロードする

スマートフォンのブラウザなどの小さな画面にAlliをロードするなどの場合には、トグルアイコンとプレビューを省略してすぐにフルスクリーンでチャットUIを読み込む必要がときがあります。以下のようにpopupModeとlauncherを使用します。

Alli.initialize({
  popupMode: true,
  launcher: false
});

popupModeがtureに設定されると、Alliはプレビューなしですぐに画面全体のチャットUIでロードされます。launcherがfalseに設定されると、切り替えのアイコンをロードしません。

ユーザーを特定する

ユーザIDで特定されないユーザの場合、Alliはcookieを使用して情報を保存します。cookie履歴を削除したり、他のデバイスを使用して接続する場合は、ユーザを特定することはできません。
ウェブサイトにログインし、ユーザが特定されている場合、Alliに情報を渡すことができます。あるいはログインしていないユーザーのために、一時的なIDを生成することもできます。

例えば、ユーザIDがUSER-123の場合は、次のように入力します。

window.Alli.event({
    user: {id: "USER-123"}
});

電子メール、アドレスなどのユーザー情報を送信する場合は、下記の「変数に値を割り当てる」セクションを参照してください。

変数の値を指定する

会話を開始するとき、特定の変数の値を変数に割り当てる場合は、以下の形式を使用します。

window.Alli.event({
    variables: {
        "VARIABLE_NAME":"VARIABLE_VALUE"
    }
});

この機能を利用すれば、特定のユーザ情報をAlliの変数に格納して利用することができます。この変数は、Alliダッシュボード（プロジェクト設定＞変数）にすでに存在している変数である必要があります。

以下は、指定したユーザーにメールを割り当てる例です。 

if (window.Alli) {
    window.Alli.event(
      {
        user: {id: "YOUR_USER_ID"},
        variables: {
            "EMAIL":"email_address@gmail.com"
        }
      }
    );
}

Placements

プレイスメント情報を設定することで、Alli SDKを特定のキャンペーンチャットフローを任意のWEBサイト（アプリ）に実装することができます。

静的な配置

Placementを作成した後、Alliダッシュボードで必要なキャンペーン（スキル）にPlacementを指定することができ、この方法で必要な場所にキャンペーン（スキル）をロードすることができます。
以下はPlacementをshoppingに呼び出す例です。

例：プレイスメント＝shopping　

window.Alli.event({
    placement: "shopping"
});

動的な配置

Alli SDKは、URL情報を自動的に送り出し、これを利用して、動的Placementを設定することができます。そのためには、単にPlacement情報の呼び出しを省略して、ダッシュボードで、次のように設定します。
たとえば、「/ download」が含まれているurlでスキル（キャンペーン）を呼びだしたい場合は、以下の様にスキルのPlacement設定を「contains 」・「download」に指定します。SPA（Single Page App）は、動的Placementを使用することはできません。

音声認識を有効にする

音声をテキストに変換することができるように音声認識を有効にします。
まず、Alliを初期化する前に以下を追加します。

var recognition = new Alli.__CustomSpeechRecognition__('wss://task.ecs-backend.alli.ai:3000/', { path: '/stt' });
recognition.interimResults = true;
recognition.maxAlternatives = 10;
recognition.continuous = true;

初期化する際に他のオプションがあれば、一緒に以下を追加します。

Alli.initialize({
  recognition: recognition
});

音声認識が正常に有効になると、テキスト入力フィールドと送信アイコンの間にマイクアイコンが表示されます。アイコンをクリックすると、音声入力が可能な状態となり、もう一度押すと停止します。

サポートしているブラウザ


・Chrome（バージョン64以降）
・FireFox（バージョン60以降）
・Opera（バージョン50以降）
・Safari（10以降）
・Internet Explorer 11
・Microsoft Edge（バージョン40以降）

AllganizeのAIソリューション