Alli SDKV1実装(JavaScriptコード)は2024年11月30日をもちまして、サポートを終了いたしました。
機能アップデート等は実施されないため、 Alli SDK V2実装（JavaScript） arrow-up-right のご利用をお願いいたします。
Alli Javascriptの実装は次のコードをコピーしてWebサイトに貼り付けるだけです。apiKeyはDashboard 設定＞全般タブのSDK キー より取得し、”YOUR_SDK_KEY”に入力します。ブラウザをリフレッシュ後、Webサイトの右下にAlliのチャットダイアログポップアップが表示されたら、実装完了です。
コードをコピーして、ウェブページの ブロックに貼り付けます。
以下のスクリプトの2行目に該当します"JavaScriptファイルについて、過去のバージョンである https://unpkg.com/@allganize/sdk をご利用のお客様におかれましては、2025年7月4日以降、当該ファイルがご利用いただけなくなります。
つきましては、お手数ですが、現在ご利用中のパスを以下のスクリプトに記載の通り、 https://sdk.alli.ai/0.10.214/alli.js へご変更くださいますようお願い申し上げます。
※ https://sdk.alli.ai/latest/alli.js は引き続きご利用いただけます。
コピー < head >
< script src = "https://sdk.alli.ai/0.10.214/alli.js" ></ script >
< meta charset = "UTF-8" >
</ head >
< body >
<!-- ...Your website content... -->
<!-- Start of Alli Code -->
< script >
Alli.initialize({
apiKey: "YOUR_SDK_KEY" ,
debug: false ,
backButton: true ,
providerLink: true ,
styleOptions: {
conversationContainer : {
right : 50 ,
left : 50 ,
bottom : 50
}
}
});
if (window.Alli) {
window . Alli .event ();
}
</ script >
<!-- End of Alli Code -->
</ body > SDKを初期化したら、以下のオプションのいずれかを使用して次のコマンドを呼び出し、会話を開始してください。
Option 1 ターゲティングおよびプレイスメントを指定しない場合
Option 2: ターゲティングとプレイスメントを指定する場合
プレイスメント情報は、Webページにロードするキャンペーンを識別するために使用されます。 Alliダッシュボード＞キャンペーン内で、各キャンペーンの配置を設定できます。
高度な設定については以下を参照してください。
＜トグルアイコン の位置を調整する＞
メインのターゲットブラウザに応じて、トグルアイコンの位置を調整できます。
script内の以下コードの値を変更し位置を変更します。StyleOptions > ConversationContainer > right, left, bottom の値を変更できます。 デフォルト値は５０となっています。
ドラッグアンドドロップでトグルアイコンが移動しないようにするには、disableToggleDragをtrueに設定します。
＜トグルアイコンとプレビューなしで全画面でAlliウィンドウをロードする＞
スマートフォンのブラウザなどの小さな画面にAlliをロードするなどの場合には、トグルアイコンとプレビューを省略してすぐにフルスクリーンでチャットUIを読み込む必要がときがあります。以下のようにpopupModeとlauncherを使用します。
popupModeがtureに設定されると、Alliはプレビューなしですぐに画面全体のチャットUIでロードされます。launcherがfalseに設定されると、切り替えのアイコンをロードしません。
ユーザIDで特定されないユーザの場合、Alliはcookieを使用して情報を保存します。cookie履歴を削除したり、他のデバイスを使用して接続する場合は、ユーザを特定することはできません。
ウェブサイトにログインし、ユーザが特定されている場合、Alliに情報を渡すことができます。あるいはログインしていないユーザーのために、一時的なIDを生成することもできます。
例えば、ユーザIDがUSER-123の場合は、次のように入力します。
電子メール、アドレスなどのユーザー情報を送信する場合は、下記の「変数に値を割り当てる」セクションを参照してください。
会話を開始するとき、特定の変数の値を変数に割り当てる場合は、以下の形式を使用します。
この機能を利用すれば、特定のユーザ情報をAlliの変数に格納して利用することができます。この変数は、Alliダッシュボード（プロジェクト設定＞変数）にすでに存在している変数である必要があります。
以下は、指定したユーザーにメールを割り当てる例です。
プレイスメント 情報を設定することで、Alli SDKを特定のキャンペーンチャットフローを任意のWEBサイト（アプリ）に実装することができます。
Placementを作成した後、Alliダッシュボードで必要なキャンペーン（スキル）にPlacementを指定することができ、この方法で必要な場所にキャンペーン（スキル）をロードすることができます。 以下はPlacementをshoppingに呼び出す例です。
例：プレイスメント＝shopping
Alli SDKは、URL情報を自動的に送り出し、これを利用して、動的Placementを設定することができます。そのためには、単にPlacement情報の呼び出しを省略して、ダッシュボードで、次のように設定します。 たとえば、「/ download」が含まれているurlでスキル（キャンペーン）を呼びだしたい場合は、以下の様にスキルのPlacement設定を「contains 」・「download」に指定します。SPA（Single Page App）は、動的Placementを使用することはできません。
音声をテキストに変換することができるように音声認識を有効にします。 まず、Alliを初期化する前に以下を追加します。
初期化する際に他のオプションがあれば、一緒に以下を追加します。
音声認識が正常に有効になると、テキスト入力フィールドと送信アイコンの間にマイクアイコンが表示されます。アイコンをクリックすると、音声入力が可能な状態となり、もう一度押すと停止します。
音声認識を非表示にする場合は、Alliを起動するサイトに埋め込んでいるJavaScript SDKの一部を下記のように変更いただけると可能になります。
Microsoft Edge （バージョン40以降
