addButtonEventHandler

Use the addButtonEventHandler method to define an automated invitation’s behavior when certain events occur.

Usage

Defines the behavior for an invitation when the following events occur:

The criteria are met for the invitation to appear on-screen.
The criteria are not met for the invitation to appear on-screen.
A customer accepts an invitation to chat.
A customer rejects an invitation to chat.

The event “the criteria are not met for the invitation to appear on the screen” occurs when a chat can’t reach an agent using the configured chat button or automated invitation. The event occurs when:

No agents are online.
No agents assigned to the skills associated with the button are online.
Online agents have the status Away.
Online agents are at capacity (set with Chat Configurations, or Presence Configurations with Omni-Channel).
Online agents are using Omni-Channel and are only available for other service channels.

Available in API versions 28.0 and later.

Syntax

void addButtonEventHandler(String buttonId, Function callback)

Parameters

Name	Type	Description	Available Versions
`buttonId`	String	The ID of the chat button associated with the automated invitation 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 invitation’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 invitation when certain events occur. You must specify the invitation’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 automated invitation when the criteria are met for the invitation to appear on-screen.
	BUTTON_UNAVAILABLE	`liveagent.BUTTON_EVENT.BUTTON_UNAVAILABLE`	Specifies the behavior of the automated invitation when the criteria are not met for the invitation to appear on-screen.
	BUTTON_ACCEPTED	`liveagent.BUTTON_EVENT.BUTTON_ACCEPTED`	Specifies the behavior of the automated invitation when a customer accepts the invitation. This event type is only available for automated chat invitations.
	BUTTON_REJECTED	`liveagent.BUTTON_EVENT.BUTTON_REJECTED`	Specifies the behavior of the automated invitation when a customer rejects the invitation. This event type is only available for automated chat invitations.

You might receive multiple events of the same type.

Note