Zoho CliqInstall

Summary

Retrieve messages from a specified Zoho Cliq chat with optional filtering parameters, returning the data in a simplified or raw format as specified.

Inputs

• Chat ID (required) — Specifies the unique Chat ID containing the messages to retrieve; this is not a Channel or Thread ID.
• Optional Filters — Optional parameters to filter the retrieved messages, including 'From Time' and 'To Time' to specify time range, and 'Limit' to restrict maximum results (up to 100).
• Enable AI Error Mode — If enabled, returns errors as output items instead of stopping execution, useful for AI tool workflows that need to handle API errors gracefully.
• Simplify — Determines whether to return a simplified version of the API response.
• Simplify Mode — Defines the mode of simplification when Simplify is enabled: 'Simplified' returns a basic simplified structure, 'Raw' returns unprocessed data, and 'Selected Fields' allows choosing specific fields to include in outputs.
• Output Fields — When using 'Selected Fields' simplify mode, select which message fields (ID, Time, Type, Sender, Content) to include; ID is always included.

Output shape

a list of message records from the specified chat.

The output format depends on the Simplify and Simplify Mode settings. In simplified output, the data is unwrapped so each message is an individual item rather than nested raw API data. Optional filters limit results by time range and maximum count. Enabling AI Error Mode changes error handling to output errors as data rather than halting execution. Requires OAuth scopes: ZohoCliq.Messages.READ for messages and ZohoCliq.Chats.READ for validating chat existence.

Examples

Example 1: Retrieve up to 100 messages from a chat starting from a specific date, returning simplified message data with selected fields including ID, Time, Sender, and Content.

Chat ID set to a valid chat identifier, Optional Filters set with From Time to desired start date and Limit to 100, Simplify enabled with Simplify Mode as Selected Fields, and Output Fields including ID, Time, Sender, and Content.

Links

• n8n community nodes installation guide