Overview#
You can integrate Discord notifications to receive real-time updates on status changes during file transfer tasks.
After completing the integration, notification messages are automatically sent to the designated Discord channel whenever designated events occur, such as a transfer being Started, Completed, or Failed.
The entire process consists of two steps: ① Obtain a Webhook URL from Discord → ② Configure notifications in the product.
Prerequisites#
Before you begin, check the following.
| Item | Description |
|---|---|
| Discord server | An account with the Manage Webhooks permission to create Webhooks is required. |
| Target channel | Prepare the text channel that will receive notifications. (Voice channels and category channels do not support Webhooks.) |
| Network | Outbound HTTPS communication to discord.com (443) must be allowed from the environment where the product is installed. |
Obtain a Discord Webhook URL#
To receive notifications in Discord, you must create a Webhook URL connected to the target channel.
Step 1. Open Integrations#
Click the server name and go to Server Settings → Integrations.
Alternatively, you can also access it from Edit Channel → Integrations for the target channel.
Step 2. Create a Webhook and Select a Channel#
Select Webhooks → New Webhook.
Enter a Webhook name, then select the channel where messages will be posted.
Step 3. Copy the Webhook URL#
Click Copy Webhook URL to copy the Webhook URL.
Then click Save Changes.
ℹ️ If you close the window without saving the changes, the Webhook may not be saved.
The Webhook URL format is as follows.
https://discord.com/api/webhooks/<id>/<token>ℹ️ A Webhook URL is sensitive information, similar to a password. Anyone who knows the URL can send messages to the channel, so make sure it is not exposed in public repositories or external documents. If the URL is exposed, you must delete the existing Webhook and create a new one.
Checklist#
- ✔ The Webhook has been created.
- ✔ The target channel has been selected.
- ✔ The Webhook URL has been copied.
Discord Notification Settings#
Enter the issued Webhook URL in the product's notification settings.
When you open the Notifications settings window, the following screen is displayed.
Step 1. Enter the Webhook URL#
Enter the copied URL in the Webhook URL field.
Step 2. Select Notification Events#
Select the events for which you want to receive notifications under Events.
You can select multiple events, and notification messages are sent only when the selected events occur.
| Event | When It Occurs |
|---|---|
| Started | When the transfer task starts |
| Completed | When the transfer is completed successfully |
| Paused | When the transfer is temporarily paused |
| Resumed | When a paused transfer starts again |
| Recovered | When the transfer is automatically recovered and resumed after an interruption or error |
| Canceled | When the user cancels the transfer |
| Failed | When the transfer fails |
| Skipped | When a specific file is skipped (Example: an existing file or a file matching a filter condition) |
Step 3. Save the Settings#
After completing the input, click Add to save the integration.
Checklist#
- ✔ The Webhook URL has been entered.
- ✔ The events for which you want to receive notifications have been selected.
Verify the Integration#
Verify that the settings are working correctly.
Step 1. Trigger a Test Event#
Run an actual transfer task or trigger one of the selected events.
Step 2. Check the Discord Channel#
Check whether a notification message has arrived in the designated Discord channel.
Checklist#
- ✔ A notification has arrived in the Discord channel.
- ✔ The triggered event was delivered accurately.
Setup Complete#
Once the settings are saved, the integration is applied.
After that, notification messages are automatically sent to the designated Discord channel whenever the selected events occur.
Troubleshooting#
If notifications do not arrive, check the following items.
| Issue | What to Check |
|---|---|
| No notifications are received at all | Check whether the Webhook URL was entered correctly (including the ID, Token, and leading or trailing spaces). |
| The Webhook is not saved | Check whether Save Changes was clicked after creating the Webhook. |
| The Webhook creation menu is missing or disabled | Check whether you have the Manage Webhooks permission and whether the target is a text channel. (Voice and category channels are not supported.) |
| A 401 or 404 error occurs | Check whether the Webhook has been deleted and create a new one if necessary. |
| Integration fails in a closed network | Check whether outbound HTTPS communication to discord.com (443) is allowed by the firewall or proxy. |