{ "opencollection": "1.0.0", "info": { "name": "Bots chats API", "version": "1.0.0" }, "items": [ { "info": { "name": "chats", "type": "folder" }, "items": [ { "info": { "name": "Retrieve all direct chats", "type": "http" }, "http": { "method": "GET", "url": "https://cliq.zoho.com/api/v3/chats", "params": [ { "name": "name", "value": "", "type": "query", "description": "Search for chats with names that partially match the provided value.
\nFor example, searching with \"pro\" may return chats named \"Project Alpha\" and \"Product Launch\".\n" }, { "name": "recipient", "value": "", "type": "query", "description": "Filter chats containing recipient.
\nProvide the recipient USER_ID to return chats that include that user as a participant.
\nTo learn how to retrieve this ID, see USER_ID in the Glossary page.
\nFor example, searching with 70027934 returns chats that include that user ID.\n" }, { "name": "muted", "value": "", "type": "query", "description": "Set this parameter to true to retrieve the list of chats which are muted by the user.\n" }, { "name": "limit", "value": "", "type": "query", "description": "The number of chats that has to be retrieved.
\nMaximum limit : 100\n" }, { "name": "modified_before", "value": "", "type": "query", "description": "Gets the list of chats where the last message is sent before the mentioned time.\n
\nThe time should be in epoch milliseconds format.
For example, 1711929600000.\n" }, { "name": "modified_after", "value": "", "type": "query", "description": "Gets the list of chats where the last message is sent after the mentioned time.\n
\nThe time should be in epoch milliseconds format.
For example, 1711929600000.\n" }, { "name": "drafts", "value": "", "type": "query", "description": "Set this parameter to true to retrieve the list of chats which have unsent messages (drafts).\n" }, { "name": "pinned", "value": "", "type": "query", "description": "Set this parameter to true to retrieve the list of chats which are pinned by the user.\n" }, { "name": "closed", "value": "", "type": "query", "description": "Set this parameter to true to retrieve the list of chats which are closed by the user.\n" }, { "name": "joined", "value": "", "type": "query", "description": "Set this parameter to true to retrieve the list of chats which are joined by the user.\n" }, { "name": "chat_ids", "value": "", "type": "query", "description": "Comma-separated list of chat IDs to filter the chats.
\nTo learn how to retrieve these IDs, see CHAT_ID in the Glossary page.
\n" }, { "name": "parent_chid", "value": "", "type": "query", "description": "Filter chats that are threads of a specific parent chat. Provide the parent chat's CHAT_ID to return all threads under that chat.
\nTo learn how to retrieve this ID, see CHAT_ID in the Glossary page.
\n" }, { "name": "type", "value": "", "type": "query", "description": "Filter chats by type.
\nAllowed values:
\n\n" } ], "auth": { "type": "oauth2", "flow": "implicit", "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth", "credentials": { "clientId": "{{clientId}}" } } }, "docs": "Use this API to get details of all direct chats.\n

\n

\n Threshold limit: 30 requests per min per user
\n Number of API calls allowed within a minute.

\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n

\n" }, { "info": { "name": "Create chat", "type": "http" }, "http": { "method": "POST", "url": "https://cliq.zoho.com/api/v3/chats", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "implicit", "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth", "credentials": { "clientId": "{{clientId}}" } } }, "docs": "Create a new direct conversation or a group chat.\n

\n

\n Threshold limit: 30 requests per min
\n Number of API calls allowed within a minute.
\n

\n
\n \nTwo bulk actions are supported, controlled by the operation field in the request body:\n