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”.
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.
Print debug message
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
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.
||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 + "'");