Integrate Discord Notifications
Overview
You can integrate Discord notifications to receive real-time updates on file transfer status changes.
After the integration is complete, a notification message is automatically sent to the designated Discord channel whenever a selected event occurs, such as Started, Completed, or Failed.
The setup consists of two steps:
① Generate a Discord Webhook URL → ② Configure notification settings in the product
Prerequisites
Before you begin, verify the following.
| Item | Description |
|---|---|
| Discord Server | A Discord account with the Manage Webhooks permission is required to create a Webhook. |
| Target Channel | Prepare a text channel to receive notifications. (Voice channels and category channels do not support Webhooks.) |
| Network | The environment where the product is installed must allow outbound HTTPS (443) connections to discord.com. |
Generate a Discord Webhook URL
To receive notifications through Discord, you must create a Webhook URL for the target channel.
Step 1. Open Integrations
Click the server name, then 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 notification 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 your changes, the Webhook may not be saved.
The Webhook URL has the following format.
The Webhook URL is equivalent to a password.
Anyone who knows the URL can send messages to the channel, so do not expose it in public repositories or external documents.
If the URL is compromised, delete the existing Webhook and create a new one.
Verification
- ✔ The Webhook has been created.
- ✔ The target channel has been selected.
- ✔ The Webhook URL has been copied.
Configure Discord Notifications
Enter the generated Webhook URL in the product's notification settings.
Open the Notifications settings window.
The following screen is displayed.
Step 1. Enter the Webhook URL
In the Webhook URL field, enter the URL copied in the "Generate a Discord Webhook URL" section.
Step 2. Select Notification Events
In the Events section, select the events for which you want to receive notifications.
You can select multiple events. Notification messages are sent only when the selected events occur.
| Event | Trigger |
|---|---|
| Started | When a transfer starts |
| Completed | When a transfer completes successfully |
| Paused | When a transfer is paused |
| Resumed | When a paused transfer resumes |
| Recovered | When a transfer automatically resumes after an interruption or error |
| Canceled | When a user cancels a transfer |
| Failed | When a transfer fails |
| Skipped | When a specific file is skipped (for example, because it already exists or matches a filter condition) |
Step 3. Save the Settings
After completing the configuration, click Add to save the integration.
Verification
- ✔ The Webhook URL has been entered.
- ✔ The notification events have been selected.
Verify the Integration
Verify that the integration works correctly.
Step 1. Trigger a Test Event
Start an actual transfer or trigger one of the selected events.
Step 2. Check the Discord Channel
Verify that the notification message has been delivered to the designated Discord channel.
Verification
- ✔ A notification has been delivered to the Discord channel.
- ✔ The event has been delivered correctly.
Setup Complete
After saving the settings, the integration is applied.
From this point on, whenever one of the selected events occurs, a notification message is automatically sent to the designated Discord channel.
Troubleshooting
If notifications are not received, check the following.
| Issue | Check |
|---|---|
| No notifications are received | Verify that the Webhook URL has been entered correctly (including the ID, Token, and any leading or trailing spaces). |
| The Webhook is not saved | Verify that you clicked Save Changes after creating the Webhook. |
| The Create Webhook menu is unavailable or disabled | Verify that you have the Manage Webhooks permission and that the target is a text channel. (Voice channels and category channels are not supported.) |
| A 401 or 404 error occurs | Verify that the Webhook has not been deleted. If necessary, create a new one. |
| Integration fails in a restricted network environment | Verify that outbound HTTPS (443) communication to discord.com is allowed through the firewall or proxy. |