Bot Welcome Handler

A welcome handler can be used to trigger a custom message, when the user subscribes to a bot. You can also configure a welcome handler to post a custom message when a user unsubscribes a bot and subscribes again. The list of attributes passed when this welcome handler is triggered are:

Example:

A sample syntax is given below, where the newuser attribute of the data type boolean, will ensure that a user subscribing to the bot receives a welcome message different from the user who re-subscribes to the bot!  The user attribute of the type Map will store the details of the user and can be used to get the user's first name, to make the message look more personalized.

// Sample Syntax For Bot Welcome Handler

response=Map();
if(newuser)
{
  response.put("text","Hey *" + user.get("first_name") + "* ! Thank you for subscribing! Click the *Actions* option in the bottom right corner of the chat window, and choose *Know Cliq Help Bot* to know more about me. Trust me, I am interesting! :wink: ");
}
else
{
  response.put("text","I guess you missed me! :smirk: Anyhoo, thanks for subscribing back.");
}
return response;

The welcome handler's deluge editor offers two options in the bottom right corner: "Save" and "Save & Execute."

• The "Save" option allows you to save your code.

• When you click "Save & Execute," you can choose between two options:

  • As New User: This option lets you see a sample execution of the logic created for a new user in the welcome handler.
  • As Existing User: This option allows you to see a sample execution of the logic designed for an existing user (a user who has unsubscribed and then resubscribed to the bot) in the welcome handler.

  

The image illustrates the Cliq Help Bot's welcome handler triggered to send a message to a user, subscribing for the first time.

The Cliq Help Bot's welcome handler message, when a user unsubscribes to the bot and subscribes again.