onNewMessage()
顧客、エージェント、またはスーパーバイザから新しいメッセージが送信されるとコールされる関数を登録します。API バージョン 29.0 以降で使用できます。
構文
1sforce.console.chat.onNewMessage(chatKey:String, callback:Function)引数
| 名前 | 型 | 説明 |
|---|---|---|
| chatKey | string | 新しい顧客メッセージを受信すると関数をコールするチャットに関連付けられた chatKey。 |
| callback | function | メソッドの完了時にコールされる JavaScript メソッド。 |
サンプルコード – Visualforce
1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page >
18 <apex:includeScript value="/support/console/29.0/integration.js"/>
19 <script type="text/javascript">
20 var eventHandler = function (result) {
21 alert('There is a new message in this chat: ' + result.content);
22 }
23 //Get the value for 'myChatKey'from the sforce.console.chat.getDetailsByPrimaryTabId() or other chat methods.
24 //These values are for example purposes only
25 var chatKey = 'myChatKey';
26 sforce.console.chat.onNewMessage(chatKey, eventHandler);
27 </script>
28</apex:page>応答
このメソッドは非同期であるため、コールバックメソッドのオブジェクトで応答を返します。応答オブジェクトには次のプロパティが含まれます。
| 名前 | 型 | 説明 |
|---|---|---|
| content | String | チャットログのメッセージのテキスト。 |
| name | String | メッセージを送信したユーザの名前。これは、チャットログとまったく同じように表示されます。 |
| type | String | 受信メッセージの種別 (エージェントメッセージや訪問者メッセージなど)。 |
| timestamp | Date/Time | メッセージの受信日時。 |
| success | Boolean | イベントが正常に起動された場合は true、イベントが正常に起動されなかった場合は false。 |