Integrate Zoho Monitoring
Overview
You can configure a Zoho integration to send file transfer activities and device status changes for monitoring.
Once configured, whenever a selected event occurs—such as Transfer Started, Transfer Completed, Device Connected, or Device Disconnected—a notification is automatically sent through an incoming Webhook to the configured Zoho destination (for example, a Zoho Cliq channel).
The overall process consists of the following steps:
① Generate a Zoho Incoming Webhook URL → ② Configure the Integration in the Product
Prerequisites
Before you begin, verify the following requirements.
| Item | Description |
|---|---|
| Zoho Account | A Zoho account with permission to create incoming Webhooks. (For Zoho Cliq, Channel Administrator permission is required.) |
| Target Channel | A Zoho Cliq channel where notifications will be delivered. |
| Network | The environment where the product is installed must be able to access the Zoho Webhook endpoint (for example, cliq.zoho.com) over HTTPS (443). |
Generate a Zoho Incoming Webhook URL
To send notifications to Zoho, generate a Webhook URL that can post messages to the target destination.
Step 1. Create an Incoming Webhook
In Zoho Cliq, open the target channel and create a Webhook from the Connectors tab. (Only Channel Administrators can configure this.)
Alternatively, open the Webhook Tokens page, select Get Webhook URL, then choose Channels and the target channel.
Step 2. Copy the Webhook URL
Copy the generated Webhook URL.
Example:
The zapikey included in the URL has the same level of access as a password. Do not expose it in public repositories or external documentation.
If it is compromised, regenerate the Webhook Token.
Verification
✔ The incoming Webhook has been created.
✔ The Webhook URL has been copied.
Configure the Zoho Integration
Enter the generated Webhook URL into the product.
When you open the Monitoring configuration page, the following screen is displayed.
Step 1. Enter the Webhook URL
Enter the generated Webhook URL.
Step 2. Select Events
Select the events to monitor.
Multiple events can be selected. Notifications will be sent only for the selected events.
| Event | Trigger |
|---|---|
| Transfer Started | When a Transfer begins. |
| Transfer Completed | When a Transfer completes successfully. |
| Transfer Paused | When a Transfer is paused. |
| Transfer Recovered | When a Transfer automatically resumes after an interruption or failure. |
| Device Connected | When a device connects. |
| Device Disconnected | When a device disconnects. |
Step 3. Save the Configuration
After completing the configuration, click Add to save the integration.
Verification
✔ The Webhook URL has been entered.
✔ The monitoring events have been selected.
Verify the Integration
Verify that the integration is operating correctly.
Step 1. Generate a Test Event
Start a Transfer or trigger one of the selected monitoring events.
Step 2. Verify in Zoho
Verify that a notification has been delivered to the target Zoho Cliq channel.
Verification
✔ The notification has been delivered to the Zoho destination.
✔ The generated event has been delivered successfully.
Configuration Complete
After the configuration is saved, the integration becomes active.
From this point forward, whenever one of the selected events occurs, a corresponding notification is automatically sent to the configured Zoho destination.
Troubleshooting
| Issue | Verification |
|---|---|
| Notifications are not delivered | Verify that the Webhook URL (including the zapikey) is correct and contains no leading or trailing spaces. |
| Authentication error (401) | Verify that the zapikey is valid, and regenerate it if necessary. |
| Messages are not posted | Verify that the Webhook is configured with permission to post to the target channel (Channel Administrator settings). |
| Connection failure in a restricted network | Verify that outbound HTTPS (443) access to the Zoho Webhook endpoint (for example, cliq.zoho.com) is allowed by the firewall or proxy. |