Integrate check in/check out notifications in Zoho Cliq with Zoho People

Hello everyone,

Today, we wanted to share with you a useful tip on how to integrate check in/check out notifications in Zoho Cliq with Zoho People. By integrating these two Zoho apps, you can ensure that your team members receive timely updates on the availability of their colleagues, making it easier to coordinate tasks and schedules.

In this forum post, we will guide you through the simple steps required to set up this integration, and provide some tips on how to get the most out of it. Whether you're a small business owner or part of a large enterprise, this integration can help streamline your team's communication and improve your overall productivity.

So without further ado, let's get started!

INSTRUCTIONS:

Note: It should be noted that this will only work if Zoho People integration is enabled in Zoho Cliq.

Enabling Zoho People integration (if available for you):
If you are a Zoho People user, you can enable the Zoho People integration in Cliq with the following steps:

Go to https://cliq.zoho.com .
Go to your profile on the top right corner and click on Admin Panel.
Navigate to the Integrations tab and enable the Zoho People integration.

Creating a bot:
Now go back to your home page and click on your Profile -> Bots & Tools. This will open the integrations page. Create a bot with channel participation permissions enabled (refer to image below).

After creating the bot, copy the bot incoming webhook URL and add an authentication to it using a webhook token. (create a webhook token and add it to the end of the URL).
Sample URL : https://cliq.zoho.com/api/v2/bots/peoplebot/incoming?zapikey=<paste_webhook_token_here>

Setting up the workflow in Zoho People:

Now go to Zoho People and navigate to Settings -> Automations -> Workflow -> Add Workflow. Choose the Form Name as Attendance, Trigger Process as "Create or Edit" then move on to Action -> Webhooks.
Now enter a name for the webhook , the URL to notify (paste the bot incoming URL from step 2), select the POST method and configure the URL parameters (day, email ID, name). Save the webhook and workflow.

Now back in Zoho Cliq, navigate to the bot incoming webhook handler and paste the code below:

emailID = params.get("emailId");
userName = params.get("name");
day = params.get("day");
bodyParameters = {"emailId":emailID};
fetchUserAvailability = invokeurl
[
url :"https://people.zoho.com/api/attendance/getUserAvailability"
type: GET
parameters:bodyParameters
detailed:true
connection:"<CONNECTION LINK NAME>"
];
info fetchUserAvailability;
if(fetchUserAvailability.get("responseCode") == 200)
{
isUserAvailable = fetchUserAvailability.get("responseText").get("isUserAvailable");
if(isUserAvailable == false)
{
status = "check-out";
}
else
{
status = "check-in";
}
//Post message in channel
actionTime = zoho.currenttime;
actionTime = actionTime.toString("dd-MMM-yyyy hh:mm a");
postMessage = {"text":"_" + userName + "_ has *" + status + "* successfully! (" + actionTime + ")"};
info zoho.cliq.postToChannelAsBot(<CHANNEL UNIQUE NAME>, <BOT UNIQUE NAME>, postMessage);
}
else
{
return {"text":"Something went wrong with the integration. Please check it!!!"};
}
return Map();

Create a connection with scope - ZOHOPEOPLE.attendance.ALL and replace the connection link name in the code (line no: 11).
Add the bot to the required channel and replace the channel unique name and bot unique name in the code(line no: 29) with the respective names.

Getting the channel unique name:
Open the respective channel -> Actions -> Channel Info -> Connectors -> Unique Name.
Getting the bot unique name:
You can get it from the bot unique name (example: https://cliq.zoho.com/api/v2/bots/peoplebot/incoming )

If everything is set up right, you will be notified in the configured channel whenever anyone checks in/checks out.

In conclusion, integrating check in/check out notifications in Zoho Cliq with Zoho People is a simple yet powerful way to enhance your team's communication and productivity. By keeping everyone informed of each other's availability, you can avoid scheduling conflicts and ensure that tasks are completed on time. Plus, with the easy-to-use integration between these two Zoho apps, getting started is a breeze. So why not give it a try today and see how it can benefit your team? We hope this post has been helpful, and please feel free to share any feedback or questions in the comments below.

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

Topic Participants
Poorvik Palanikumar
Cuandu
jijo
Gowtham
Shah

Sticky Posts
Convert a message on Cliq into a task on Zoho Connect
Message actions in Cliq are a great way to transform messages in a conversation into actionable work items. In this post, we'll see how to build a custom message action that'll let you add a message as a task to board on Zoho Connect. If you haven't created
Cliq Bots - Post message to a bot using the command line!
If you had read our post on how to post a message to a channel in a simple one-line command, then this sure is a piece of cake for you guys! For those of you, who are reading this for the first time, don't worry! Just read on. This post is all about how
Cliq Bots - How to make a bot respond to your messages?
Bots are just like your buddies with whom you can interact. They carry out your tasks, keep you notified about your to-dos and come in handy when you need constant updates from a third party application. So, how can you make your bot respond to a message? The bot message handler is a piece of code triggered when a message is sent to the bot. Message handlers help you customise your bot responses to make it look conversational. The message input from the user can be either a string or an option selected
Cliq Bots - Get notifications about any action on an application with the incoming webhook handler!
Webhooks can be used to get notified about events happening in other applications inside Cliq. All bots in Cliq have their own incoming webhook endpoint. This makes it simple to post messages to the bot from external applications. Unlike the send message
The Slash Command Series - Types of Command Suggestions
Hi Everybody! I hope you guys tried the /zdocs command and now have an idea of how command suggestions with click to execute work. If you have no clue of what command suggestion is, I recommend you to take a look at all the Slash Command Series posts, especially the one on Command Suggestions ! This post is all about the different types of command suggestions. Customise your command suggestions Did you know you could customise your command suggestion list with a title, description, image? Well,