Live Agent Developer's Guide
jNewer Version Available
addButtonEventHandler
Use the addButtonEventHandler method to define a
chat button’s behavior when certain events occur.
Available in API versions 28.0 and later.
Usage
Defines the behavior for a chat button when the following events occur:
- An agent is available to chat.
- No agents are available to chat.
Syntax
void addButtonEventHandler(String buttonId, Function callback)
Parameters
| Name | Type | Description | Available Versions |
|---|---|---|---|
| buttonId | String | The ID of the chat button for which to define the behavior when certain events occur. | Available in API versions 28.0 and later. |
| callback | function | The function to call when a particular event occurs. You must specify the button’s behavior for each of the required event types. | Available in API versions 28.0 and later. |
Event Types
Incorporate the following event types into your callback function to customize the behavior of your button when certain events occur. You must specify the button’s behavior for each of the following event types.
| Function | Event Type | Syntax | Description |
|---|---|---|---|
| callback | BUTTON_AVAILABLE | liveagent.BUTTON_EVENT.BUTTON_AVAILABLE | Specifies the behavior of the button when the criteria are met for customers to be able to chat with an agent, such as when an agent with the correct skills is available to chat. |
| BUTTON_UNAVAILABLE | liveagent.BUTTON_EVENT.BUTTON_UNAVAILABLE | Specifies the behavior of the button when no agents are available to chat. |