Get Chat Event Notifications

Get notified when certain chat events are triggered. Subscribe to events by calling embedded_svc.addEventHandler() in your Snap-ins Chat code snippet.

Calls to embedded_svc.addEventHandler() must take place before calls to embedded_svc.init(). If your code snippet contains calls to embedded_svc.init(), make sure that you enter your calls in the correct order.

Important

The following events broadcast an object back to the client. They use the following format.

1{
2        liveAgentSessionKey: chasitorData.chatKey
3    }

eventName	Scenario
onAgentMessage	Fired when the agent sends a message.
onChasitorMessage	Fired when the chat visitor sends a message.
onChatEndedByAgent	Fired when the agent ends the chat.
onChatEndedByChasitor	Fired when the chat visitor ends the chat.
onChatReconnectSuccessful	Fired when the chat reconnects successfully.
onChatRequestSuccess	Fired when the chat request is successful.
onChatTransferSuccessful	Fired when a chat transfer is successful.
onConnectionError	Fired when the connection to the agent is lost.
onIdleTimeoutOccurred	Fired when a chat times out due to the visitor being idle. The chat ends and the visitor sees a message that the chat has ended.

The following events broadcast back to the client but don’t broadcast any data.

eventName	Scenario
onClickSubmitButton	Click handler for the "Submit" button in the offline support UI component.
onHelpButtonClick	Callback to fire when the help button is clicked.
onInviteAccepted	Accepts the automated chat invitation.
onInviteRejected	Rejects the automated chat invitation.

Code Example

The following code is an example of how these events can be used in your Snap-ins Chat code snippet.

1embedded_svc.addEventHandler("onHelpButtonClick", function(data) {
2    console.log("onHelpButtonClick event was fired.");
3});
4
5embedded_svc.addEventHandler("onChatRequestSuccess", function(data) {
6    console.log("onChatRequestSuccess event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
7});
8
9embedded_svc.addEventHandler("onChatEstablished", function(data) {
10    console.log("onChatEstablished event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
11});
12
13embedded_svc.addEventHandler("onChasitorMessage", function(data) {
14    console.log("onChasitorMessage event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
15});
16
17embedded_svc.addEventHandler("onAgentMessage", function(data) {
18    console.log("onAgentMessage event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
19});
20
21embedded_svc.addEventHandler("onChatTransferSuccessful", function(data) {
22    console.log("onChatTransferSuccessful event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
23});
24
25embedded_svc.addEventHandler("onChatEndedByChasitor", function(data) {
26    console.log("onChatEndedByChasitor event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
27});
28
29embedded_svc.addEventHandler("onChatEndedByAgent", function(data) {
30    console.log("onChatEndedByAgent event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
31});
32
33embedded_svc.addEventHandler("onIdleTimeoutOccurred", function(data) {
34    console.log("onIdleTimeoutOccurred event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
35});
36
37embedded_svc.addEventHandler("onConnectionError", function(data) {
38    console.log("onConnectionError event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
39});
40
41embedded_svc.addEventHandler("onClickSubmitButton", function(data) {
42    console.log("onClickSubmitButton event was fired.  liveAgentSessionKey was " + data.liveAgentSessionKey);
43});
44embedded_svc.addEventHandler("onInviteAccepted", function(data) {
45    console.log("onInviteAccepted event was fired.");
46});
47
48embedded_svc.addEventHandler("onInviteRejected", function(data) {
49    console.log("onInviteRejected event was fired.");
50});

Snap-Ins for Web Developer Guide

Get Chat Event Notifications

Code Example