Use the following built-in functions to log events and print debug messages.

Log custom event

logCustomEvent is used for tracking specific bot events for the purposes of analytics. This function requires some type of user message and event name. The event detail is optional. In the example, we are setting the user message to the currentUserMessage and naming the event “Invoice API”.

Function Name Arguments Returns
logCustomEvent(user_message, event_name, event_detail) user_message - the user's message text

event_name - string

event _detail - string; any optional detail


botContext.logCustomEvent(botContext.getCurrentUserMessage(), 'Invoice API', 'API call successful');

For a step-by-step, example guide on implementing custom event logging, see here.

To view the details of a custom event, in Bot Analytics you must click Download Event Details (not Download) and examine the downloaded CSV file.

Log escalation event

logEscalationEvent is used to count the number of times the user called a particular escalation type. The function requries a user input and the string 'LivePerson' for the type of escalation.

Function Name Arguments Returns
logEscalationEvent(user_message, escalation_type) user_message - the user's message text

escalation_type - 'LivePerson'


botContext.logEscalationEvent(botContext.getCurrentUserMessage(), 'LivePerson');

printDebugMessage is used to log debug messages to the console. For example, in the code example below, the response variable stores the most recent message from the consumer, which we print to the console using printDebugMessage.

Using Print Debug Message to display messages or values from within your JavaScript is an extremely helpful way of validating your code at various points in the flow. You can print debug messages until you're confident that the implementation is working as you expect.

Keep in mind that simply printing a debug message might not always reveal an issue. It can be helpful to use quotation marks to clearly indicate the start and the end of the debug message; this lets you see leading/trailing white space, new lines due to \n, and so on.

Logged debug messages are displayed in the bot's logs.

Function Name Arguments Returns
printDebugMessage(message) message (string) – A message to print to the debug logs None


// get what the user just said
var response = botContext.getCurrentUserMessage();
botContext.printDebugMessage("User said '" + response + "'");