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

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

In a remote or hybrid work culture, one of the most significant pain points for teams is the constant uncertainty of colleague availability. Unanswered emails, missed Cliq pings, and irregular coordination lead to frustrating delays. To enhance overall productivity, let's integrate check-in/check-out notifications in Zoho Cliq with Zoho People.



This provides real-time alerts on your team's status so that everyone knows who's online, who's stepping away, and when to expect responses, empowering smoother collaboration without guesswork

Step 1: Enabling Zoho People integration (if available for you)

If you are a Zoho People user, you can enable the Zoho People integration in Cliq by following these steps:
  1. Navigate to https://cliq.zoho.com.
  2. Click on your profile in the top right corner, then select "Admin Panel."
  3. Go to the "Integrations" tab and enable the Zoho People integration.

Step 2 : Creating bot and generating webhook tokens

  1. Return to the Cliq homepage, click on your profile in the top-right corner, and select "Bots and Tools."
  2. To create a new bot, click on "Create Bot" located on the right side under the "Bots" section.
  3. Provide a name and description for the bot, and enable the channel configuration settings during the setup process.
  4. After creating the bot, copy the bot's incoming webhook URL and add authentication to it using a webhook token. (Create a webhook token and append it to the end of the URL.)


The Bot Incoming Webhook Endpoint facilitates real-time notifications. When connected to this endpoint, your Cliq component can promptly receive and process notifications from external sources.
Example: https://cliq.zoho.com/api/v2/bots/{$bot-unique-name}/incoming?zapikey={paste_webhook_token_here}

Step 3 : Setting up the workflow in Zoho People

  1. To connect Zoho People with your Cliq bot, start by navigating to Zoho People → Settings → Attendance → Automations → Workflow, and click Add Workflow.

  1. Select "Attendance" as the Form Name and set the Trigger Process to "Create" or "Edit". Next, move to the Action section and select Webhooks.
  2. In the webhook configuration, provide your webhook with a suitable name and paste the bot's incoming webhook URL (the one generated earlier) into the URL to Notify field.
  3. Set the method to POST, then configure the URL parameters as day, emailId, and name. Once you're done, save the webhook and the workflow.


Step 4: Setting up your bot to receive incoming webhooks

  1. Go back to Cliq and navigate to the bot's incoming webhook handler. To do this, click on the top right corner of your profile, then select "Bots and Tools."
  2. Under the "Bots" section, hover over the newly created bot and click "Edit Handlers." Find the incoming webhook handler and click "Edit Code."
  3. Now, copy and paste the code below, then click "Save."  
Pre-requisites:

Before beginning to script the code below, we must create a connection in Cliq with Zoho People. Once a connection is created and connected, you can use it in Deluge integration tasks and invoke URL scripts to access data from the required service.

Create a Zoho People default connection with any unique name with the scope - ZOHOPEOPLE.attendance.ALL  and replace the connection link name in code snippet line no:11.
ⓘ Document for reference : Connections in Cliq

To post an alert to the channel, you need the unique names of both the channel and the bot, as we are using zoho.cliq.postToChannelAsBot deluge task in the code below. Follow the steps to retrieve these names.

How to obtain or locate the channel unique name in Cliq?
      Navigate to the top right corner of the preferred channel and locate the three dots. Click it.
      In the menu that appears, select "Channel info" and a pop-up will open, displaying detailed channel information. Hover over the "Connectors" section and click it.
      Under "API Parameters," you will find the channel unique name.

How to obtain or locate the bot unique name in Cliq?
      Navigate to "Bots & Tools", and under the bots section, select the bot you prefer.
      Copy the API endpoint URL. The bot's unique name is located after "bots/" and before the next slash "/".

Example: URL: https://cliq.zoho.com/company/2345678/api/v2/bots/attendancetracker/message
The bot unique name in the above example is attendancetracker
  1. emailID = params.get("emailId");
  2. userName = params.get("name");
  3. day = params.get("day");
  4. bodyParameters = {"emailId":emailID};
  5. fetchUserAvailability = invokeurl
  6. [      
  7.       url :"https://people.zoho.com/api/attendance/getUserAvailability"
  8.       type :GET            
  9.       parameters:bodyParameters      
  10.       detailed:true      
  11.       connection:"<CONNECTION LINK NAME>"
  12. ];
  13. info fetchUserAvailability;
  14. if(fetchUserAvailability.get("responseCode") == 200)
  15. {
  16.       isUserAvailable = fetchUserAvailability.get("responseText").get("isUserAvailable");      
  17.       if(isUserAvailable == false)      
  18.       {      
  19.             status = "check-out";
  20.       }
  21.       else
  22.       {
  23.             status = "check-in";
  24.       }
  25.       //Post message in channel      
  26.       actionTime = zoho.currenttime;
  27.       actionTime = actionTime.toString("dd-MMM-yyyy hh:mm a");
  28.       postMessage = {"text":"_" + userName + "_  has *" + status + "* successfully! (" + actionTime + ")"};
  29.       info zoho.cliq.postToChannelAsBot(<CHANNEL UNIQUE NAME>, <BOT UNIQUE NAME>, postMessage);
  30. }
  31. else
  32. {
  33.       return {"text":"Something went wrong with the integration. Please check it!!!"};
  34. }
  35. return Map();

Everything is all set up! You'll receive a notification in the designated channel anytime there's a check-in or checkout.

Wrapping it up

Automating check-in and checkout alerts with Zoho People and Zoho Cliq stands as a visible proof of how small, targeted enhancements can yield substantial returns in team dynamics and output. Having transparency in employee availability not only reduces miscommunications but also cultivates a more responsive and unified workforce.

We're here to help, so don't hesitate to reach out to support@zohocliq.com with any questions or if you need assistance in crafting even more tailored workflows.


      • Sticky Posts

      • Customer payment alerts in Zoho Cliq

        For businesses that depend on cash flow, payment updates are essential for operational decision-making and go beyond simple accounting entries. The sales team needs to be notified when invoices are cleared so that upcoming orders can be released. In contrast,
      • Automating Employee Birthday Notifications in Zoho Cliq

        Have you ever missed a birthday and felt like the office Grinch? Fear not, the Cliq Developer Platform has got your back! With Zoho Cliq's Schedulers, you can be the office party-cipant who never forgets a single cake, balloon, or awkward rendition of
      • Accelerate Github code reviews with Zoho Cliq Platform's link handlers

        Code reviews are critical, and they can get buried in conversations or lost when using multiple tools. With the Cliq Platform's link handlers, let's transform shared Github pull request links into interactive, real-time code reviews on channels. Share
      • App Spotlight : PagerDuty for Zoho Cliq

        App Spotlight brings you hand-picked apps to enhance the power of your Zoho apps and tools. Visit the Zoho Marketplace to explore all of our apps, integrations, and extensions. In today's fast-paced world, seizing every moment is essential for operational
      • Automate your status with Cliq Schedulers

        Imagine enjoying your favorite homemade meal during a peaceful lunch break, when suddenly there's a PING! A notification pops up and ruins your moment of zen. Even worse, you might be in a vital product development sprint, only to be derailed by a "quick

        • Recent Topics

        • Accounting on the Go Series-54: Effortlessly Find Your Zoho Books Customers in Your Phone’s Contact List

          Hello Zoho Books users! How are you all ? We’re happy to share a handy new feature in Zoho Books mobile app. Now, you can access your Zoho Books customers right from your phone's contact list, making it easier to stay connected on the go. How this can
        • Integration of Phase 2 -e-invoicing- KSA

          Zoho Team, I want to get a training of integration of phase 2 invoicing KSA in zoho step by step.
        • I can not save new invoice

          Hello Now I am trying to save a new invoice but I can not save it because showing unpaid invoice warning which are not overdue. Please let me know how to skip unpaid invoice warning letter and save new invoice. Thank you
        • ADD CONDITIONS FOR FIELD IN ZOHO BOOKS TEMPLATE CUSTOMAZATION

          HELLO I WANT TO ADD CONDITIONS FOR FIELD IN ZOHO BOOKS TEMPLATE CUSTOMAZATION FOR SALES ORDER . I HAVE SET %StatusStamp% IF APPROVAL I WANT THAT TEXT TO BE DISPLAYED WITH GREEN COLOR OTHERWISE OF OTHERR STATUS RED COLOR AS SHOWN IN CODE BELOW . BUT IT
        • Accounting on the Go Series-55: Seamlessly Add New Vendors While Creating Transactions from Scanned Documents

          Hi there! We’ve made handling documents and vendors in Zoho Books even simpler. Now, when you upload a document and scan it, if the app detects a vendor that isn’t already in your organization, you don’t have to leave the page to add them manually. With
        • Accounting on the Go Series-57: Effortlessly Add and Manage Bank Accounts from the Zoho Books Mobile App

          Hi all, Great news for our users in the US and Canada! Managing your finances just got a whole lot easier. Zoho Books has always made it seamless to integrate bank accounts and fetch feeds automatically. Now, we’re taking it up a notch—directly from the
        • Accounting on the Go Series:58-Effortless Compliance: Download XML for Invoices & Credit Notes on Mobile

          Hi there! In Mexico, XML files are crucial for electronic invoicing and fulfilling SAT (Tax Administration Service) requirements. These files ensure your transactions are accurately recorded and tax-compliant. Now, you don’t need to rely on the web app
        • Auto Generated Invoice number YEAR

          Auto Generated Invoice number shows transaction year as 25 even though it's 24 still.
        • Books generiert keine valide XRechnung

          Hallo zusammen, ich möchte hier ein Problem ansprechen, das mir aktuell bei der Nutzung von Books erhebliche Schwierigkeiten bereitet, und hoffe auf Austausch oder Lösungsansätze von anderen Nutzern. Bei der Erstellung von XRechnungen mit Books treten
        • WHEN UPDATE ORGANIZATION INFO OLD INVOICES ALSO CHANGE INVOICING DATA

          Hi We have updated our tax information because we have become a company, up until now we were an individual. The problem is that when updating the data in the zoho books profile all the old invoices change their tax information as well. Is there a way
        • Invoice import error - duplicate customer name column - there are no duplicates

          It is not allowing the importing of any rows because of a duplicate customer name problem, but there are no duplicates in the custoemr name row. Has anyone dealt with this issue before?
        • [WEBINAR][Feb 2025] Automate your entire financial operations from receipts to reconciliation with Zoho Books & Zoho Expense integration

          Hello there, We are hosting a free, live webinar on the importance of travel and expense management solutions for businesses, and how Zoho Expense automatically syncs with Zoho Books to simplify your accounting even further. The webinar is on February
        • Customize Layout

          I am using "Customize Layot" for customize Quotation template but I try to add logo into the header by "%ScaledLogoImage%" code but dont add logo into header. what is problem?
        • Problem - cant add Users (i.e. Zoho one / CRM Users) to BCC or CC in email, i.e. Sales orders or Retainers

          I can go to zoho books email templates, and select any email template, and automatically include any Zoho One user, i.e. member of staff. However in the context of sending an email, it will not let us add a member of staff from the user list, instead
        • UK MTD ITSA

          UK Making Tax Digital for Income Tax I have had notice this is to apply from April 2026. What is Zoho doing about this? I will need to start planning to implement this in the next months so need an update as to what I will and will not be able to do in
        • Partial refunds

          I am trying to process refund for a one item invoice, however the refund is partial: i am getting this error while creating credit note, can anyone share some wisdom about this
        • Zoho Books Roadshows are back in the UAE!

          Hello there, Business owners and accounting professionals of the UAE, we’re coming to your cities! FTA accredited Zoho Books is now officially one of the Digital Tax Integrators in the UAE. With the newly launched direct VAT filing capabilities, we're
        • New user After moving over from QBO

          New user observations/suggestions. QBO took away a lot of features I was used to with the desktop version. Chaos ensued. Zoho Books has a lot of what I was used to and a bit more. Good deal Some things I have run into and suggest some upgrades. 1: The
        • Sole Trader - Financial Advisor (Appointed Representative) - Paid via Capital Account but no Invoicing...

          Hi. I'm about to venture into a new business after 12 months of intensive learning/exams. A little chuffed if I may say so especially at 52! I really like the look of ZoHo Books for my modest enterprise but I'm in need of some guidance, please. My services
        • Multi-Unit Inventory with Flexible Unit Selection (Purchase in One Unit, Sell in Another)

          We need multi-unit inventory management in Zoho Books with the flexibility to choose units (e.g., Box or Piece) at the time of purchase or sale. For example, if 1 Box = 10 Pieces, we should be able to record purchases in Boxes but sell either in Boxes
        • Disputed Purchase Invoices

          We have recently moved to Zoho Books from Sage. In Sage we were able to post a purchase/vendor invoice but mark it as on dispute. This would usually be a pricing query or if something was damaged. It would show in their ledger, so we could agree their
        • No TDS Deduction

          In some of our case, where we are reselling items at the same rate we purchased. In this scenario, Indian IT Law has a provision to request customer not to deduct TDS if the transaction value is same. TDS is paid by us (intermediary reseller) before we
        • CBSA - GST CHARGES on imports

          Hi there, We have a questions about landed cost categorization. We received a shipment from overseas. CBSA invoiced us for the GST on the items. Now we entered the CBSA-GST as a separate bill and attached it as landed cost to the main invoice based on
        • Zoho Books

          How do I manually insert opening balance?
        • Sales order & purchase order item links for item details

          This is fantastic for checking lots of things, I use it a lot. It would be great to see it extended to invoices & bills On another note, may as well throw in my favourite whinge ..... Wish you guys would get the PO receive differences sorted urgently,
        • Bank charges are applied. Please select a bank account.

          Hello, I'm trying to add bank charges to a customer payment, but I get the error message "Bank charges are applied. Please select a bank account." I found this old thread, where it says that I need to "select a Bank account for the 'Deposit To' dropdown
        • How to add receipts

          How to add receipts
        • Support for auto-upgrade in TrueSync (for Windows)

          WorkDrive TrueSync app now supports auto-upgrading to the latest version for Windows OS. You must manually download and install the TrueSync app version 3.4.0 to avail this feature. Download the latest TrueSync app for Windows (version 3.4.0) Supported
        • WorkDrive API Documentation

          WorkDrive provides users and developers an extensive set of APIs to help integrate functionalities of Zoho WorkDrive with other Zoho applications and third-party tools. We have published the official WorkDrive API Documentation page for all external users.
        • March 15, 2023: Zoho Docs is discontinued

          As of today (March 15, 2023) Zoho Docs is discontinued for all users. We would like to thank our customers for trusting us for so many years! Going forward, we're confident you'll enjoy using Zoho WorkDrive for all your advanced file management and collaboration
        • Introducing WorkDrive 4.0: Enhanced productivity. Advanced data administration. (Phase 1)

          Hello All, We're excited to share the release of WorkDrive 4.0, which includes important new features and enhancements focused primarily on productivity, secure collaboration, data administration, integrations, and user experience. Read the official announcement
        • External download link limit

          Can You please help us to understand this For Zoho WorkDrive external users, the download limit is a maximum of 5 GB total download size and a maximum of 50 first-level files and folders What is the meaning of first level? We are using these files in
        • Dynamically catching new file creations

          I have a team folder with many subfolders, and in those folders we add new documents all the time. I'd like to have a workflow or script to notify me (and then take other actions) when a file is added anywhere in that structure that ends in "summary.txt".
        • Rotate an Image in Workdrive Image Editor

          I don't know if I'm just missing something, but my team needs a way to rotate images in Workdrive and save them at that new orientation. For example one of our ground crew members will take photos of job sites vertically (9:16) on his phone and upload
        • Workflow workdrive rollout

          Hi! When will workflow be rolled out to all users? Thanks.
        • Creating and managing a Team Folder using WorkDrive TrueSync

          Hello everyone, Are you tired of constantly switching between your Desktop TrueSync app and the WorkDrive web app to create and manage Team Folders? We’ve made things easier for you. You can now create and manage Team Folders directly within the TrueSync
        • Edit images seamlessly with WorkDrive's built-in Image Editor

          Are you tired of switching between multiple tools just to make simple edits to your images? We understand the hassle, which is why Zoho WorkDrive now comes with a built-in image editing tool, powered by Zoho Annotator. This tool allows you to edit images
        • Supercharge your email workflow with WorkDrive's add-in for Microsoft Outlook

          Consider this: You’re handling a critical project, and your inbox is packed with important attachments, email threads, and client communications. The back-and-forth routine of downloading files to your computer, uploading them to WorkDrive, and manually
        • Secure and promote your content with Custom Watermarking

          Imagine this: You’re a professional photographer who regularly shares your work online with potential clients and collaborators. Recently, you notice that some of your images have been reposted without any credit or permission. This not only impacts your
        • Join us in Singapore for the Zoho WorkDrive User Group meetup!

          Hello, everyone! Exciting news! We'll be hosting an upcoming Zoho WorkDrive user group meetup in the beautiful city of Singapore this November. At this Zoho User Group meetup, we'll guide you through ways to use WorkDrive as a platform and build custom
        • Next Page