Zoho CliqInstall

Summary

Schedule a message to be sent to a specified Zoho Cliq chat either at a predetermined date and time with timezone support or triggered by a user status change event.

Inputs

• Schedule Mode (required) — Specify whether to schedule the message by exact time ('Time-Based') or upon a user status change ('Status-Based').
• Schedule Time (required) — For 'Time-Based' mode, provide the ISO 8601 basic format date-time (e.g., '20270109T143000') for when the message should be sent.
• Schedule Timezone — For 'Time-Based' mode, specify the canonical IANA timezone (e.g. 'America/New_York').
• Schedule Status (required) — For 'Status-Based' mode, select the user status event (check in, available, call end, check out) triggering the message. Only allowed in direct message chats.
• Chat ID (required) — The exact Chat ID where the message will be scheduled. This must be a valid chat conversation ID, not a Channel or Thread ID.
• Message Type (required) — Choose the format of the outgoing message: plain text with Cliq Markdown, rich/card message, or advanced raw JSON payload.
• Text — When 'Message Type' is Text, provide the message content in Zoho Cliq Markdown, optionally with mentions.
• Mentions — Optional guided mentions to include in the text message, such as users, teams, or channels, either appended or prepended.
• JSON — When 'Message Type' is 'Advanced (JSON)', provide the raw JSON object with at least a top-level 'text' string.
• Post as Bot — For time-based messages, indicate if the message should be posted as a bot, supplying the exact bot unique name if enabled.
• Simplify — Choose whether to return a simplified or raw version of the API response.
• Enable AI Error Mode — If enabled, returns API errors as output items instead of failing execution, useful in AI workflows.

Output shape

a list of message scheduling result items, each representing the created scheduled message

The output can be simplified to include selected fields such as ID, time, creator, and message content or returned raw as per user configuration. Requires scope 'ZohoCliq.messages.CREATE' for sending; 'ZohoCliq.Chats.READ' is needed for chat validation when applicable.

Examples

Example 1: Schedule a text message to be sent at a specific time with timezone, mentioning users.

Set Schedule Mode to 'Time-Based', provide schedule time and timezone, enter the Chat ID, select Message Type as 'Text', enter the text with optional mentions, and optionally enable 'Post as Bot' with bot unique name.

Example 2: Schedule a message to send when user status changes (e.g., becomes available).

Set Schedule Mode to 'Status-Based', select the triggering 'Schedule Status', specify Chat ID (must be a direct message chat), define message content and type.

Links

• n8n community nodes installation guide