Live Agent 開発者ガイド
jshowWhenOnline
showWhenOnline メソッドは、特定のボタンがオンラインの場合に顧客に表示される内容を指定するために使用します。
使用方法
指定したボタンがオンラインの場合に、特定の要素を表示します。API バージョン 28.0 以降で使用できます。
構文
void showWhenOnline(String buttonId, Object element, (optional) String userId)
パラメータ
| 名前 | 型 | 説明 | 使用可能なバージョン |
|---|---|---|---|
| buttonId | String | ボタンに関連付けられているエージェントがチャットに対応できる場合に、指定した element オブジェクトを表示するチャットボタンの ID。 | API バージョン 28.0 以降で使用できます。 |
| element | Object | 指定したボタンがオンラインの場合に表示する要素。 | API バージョン 28.0 以降で使用できます。 |
| (省略可能) userId | String | ボタンに関連付けるエージェントの ID。エージェントが対応できる場合に、element オブジェクトが表示されます。 | API バージョン 29.0 以降で使用できます。 |
パラメータにボタン ID を指定してエージェント ID は指定しない場合、要素はボタンがオンラインの場合にのみ表示されます。
パラメータにエージェント ID を指定してボタン ID は指定しない場合、要素はエージェントがオンラインの場合にのみ表示されます。たとえば、次の構文は、エージェントのオンライン状況を追跡し、エージェントが対応できる場合にボタンをオンラインに設定します。ただし、エージェントが対応できない場合は、ボタンはオフラインに設定されます。
1liveagent.showWhenOnline('005xx000001Sv1m', document.getElementById('liveagent_button_toAgent_online')1liveagent.showWhenOnline('573xx0000000006', document.getElementById('liveagent_button_online_573xx0000000006_USER1'), '005xx000001Sv1m');