Zoho Cliq icon

Zoho Cliq

Fully manage your Zoho Cliq workspace: messages, channels, teams, users, databases, events, reminders, bots, files, and more

Actions168

Bot → Trigger Bot Calls

AI-generated

Summary

Initiates a voice alert bot call to specified Zoho Cliq users, optionally with retry loops, repeat message settings, and action buttons.

Inputs

  • botUniqueName (required) — Unique identifier for the bot (lowercase letters only, a-z).
  • inputMode — Select 'Using Fields Below' for guided payload creation or 'Using JSON' to provide a full payload object.
  • text (required) — Voice alert message text (max 500 characters).
  • userIds — Comma-separated list of target user IDs or emails. Leave empty to call all subscribers (max 10 entries).
  • retry — Number of retry attempts if users miss the first call (1-3).
  • loop — Number of times the voice message repeats per call (1-3).
  • actions — Collection of action buttons (Open URL, Invoke Function, System API, Open Dialog) shown during the call.
  • appkey — Extension app key, required only when the bot belongs to an extension app.
  • enableAiErrorMode — Whether to return API errors as output items (continue-on-fail) instead of stopping execution.
  • includeEnhancedOutput — Whether to wrap API responses with workflow context (success, bot name, request summary).
  • callPayload — Raw call payload object (used when inputMode is 'raw').

Output shape

One output item per input item containing the API response (wrapped or standard).

Errors are returned as output items if 'Enable AI Error Mode' is enabled. The response shape depends on 'Include Enhanced Output'.

Examples

Example 1: Send a voice alert to a specific user with a retry.

Bot Unique Name: myBot; Text: 'Meeting in 5 minutes'; User IDs: 123456789

Example 2: Send a voice alert with a button that opens a URL.

Bot Unique Name: myBot; Text: 'Click to view details'; Actions: Open URL button pointing to https://example.com

Example 3: Send a voice alert using a custom JSON payload.

Input Mode: JSON; Call Payload: { 'text': 'Custom message', 'user_ids': ['123', '456'] }

Links

Discussion