Implementing the Command Execution Handler

What are execution handlers?

When a user triggers a command, a deluge function mapped to the command gets executed and renders a response. Upon triggering a command, certain attributes are passed to the deluge code. They are listed below:

Rendering a response:

The return value on executing a command can either be visible to the command executor only or can be posted as a response message to the chat with the help of the deluge task, zoho.cliq.postToChat

Example:

The /traffic command can get the traffic details when mention the from and to locations! Take a look at the sample syntax given below and refer the screenshots to see the command's response.

from = options.get("from");
to = options.get("to");
fromLoc = "";
toLoc = "";
mapUrl = "https://www.google.co.in/maps/dir/" + encodeurl(from) + "/" + encodeurl(to) + "/";
resp = getUrl("https://maps.googleapis.com/maps/api/distancematrix/json?origins=" + encodeurl(from) + "&destinations=" + encodeurl(to) + "&departure_time=now&key=");
info resp;
status = resp.toMap().get("status");
if(status == "OK")
{
    if(fromLoc == "")
    {
        fromLoc = resp.toMap().get("origin_addresses").get(0);
        fromLoc = fromLoc.replaceall("\"","");
        cnt = fromLoc.getOccurenceCount(",");
        if(cnt >= 1)
        {
            city = fromLoc.substring(0,fromLoc.indexof(","));
            fromLoc = city;
        }
    }
    if(toLoc == "")
    {
        toLoc = resp.toMap().get("destination_addresses").get(0);
        toLoc = toLoc.replaceall("\"","");
        cnt = toLoc.getOccurenceCount(",");
        if(cnt >= 1)
        {
            city = toLoc.substring(0,toLoc.indexof(","));
            toLoc = city;
        }
    }
    elem = resp.toMap().get("rows").get(0).get("elements").get(0).toMap();
    message = Map();
    if(elem.get("status") == "OK")
    {
        duration = elem.get("duration").toMap().get("text");
        distance = elem.get("distance").toMap().get("text");
        card = Map();
        card.put("title",fromLoc + " <-> " + toLoc);
        message.put("card",card);
        card.put("thumbnail","");
        message.put("text",distance + " \n(Actual, " + duration + ")\n[more..](" + mapUrl + ")");
    }
    else
    {
        message.put("text","Couldn't locate.. Try [here](" + mapUrl + ")");
    }
    return message;
}
else
{
    message = Map();
    message.put("text","Sorry, traffic is currently unavailable");
    return message;
}