Live Agent 開発者ガイド
jshowWhenOffline
showWhenOffline メソッドは、特定のボタンがオフラインの場合に顧客に表示される内容を指定するために使用します。
使用方法
指定したボタンがオフラインの場合に、特定の要素を表示します。API バージョン 28.0 以降で使用できます。
構文
void showWhenOffline(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.showWhenOffline('005xx000001Sv1m', document.getElementById('liveagent_button_toAgent_offline')1liveagent.showWhenOffline('573xx0000000006', document.getElementById('liveagent_button_offline_573xx0000000006_USER1'), '005xx000001Sv1m');