How to Set Up the Discord Webhook
This guide explains how to set up the API webhook to send notifications to Discord.
Prerequisites
- Have administrative access to the Discord server
Step 1: Install the Arkyn bot on the server
-
-
Select the Discord server where you want to install the bot.
-
Make sure the necessary permissions are checked:
- Read Messages/View Channels: To access channels.
- Send Messages: To send notifications.
- Read Message History: To check previous messages.
- Click "Authorize" to install the bot.
Step 2: Get the Channel ID
-
In Discord, go to User Settings (gear icon).
-
In Application Settings, enable Developer Mode.
-
Navigate to the channel where you want to receive notifications.
-
Right-click the channel name.
-
Select "Copy ID" from the context menu.
-
Save this ID—you'll need it to set up the webhook.
Step 3: Configure Channel Permissions
Make sure the bot has the necessary permissions in the channel. Selected:
-
Right-click the channel
-
Select "Edit Channel"
-
Go to the "Permissions" tab
-
Find the bot in the members/roles list
-
Make sure the following permissions are enabled:
- ✅ View Channel
- ✅ Send Messages
- ✅ Read Message History
Step 4: Create the Webhook in the API
-
Access the [webhook creation endpoint](/api /api/webhook/createwebhook)
-
Use the channel ID copied in Step 2
-
Create the bot with the channel ID, choosing the discord type. The severity level should be fatal, warning, or info.
Verification
After configuring the webhook:
- Send a test message via the API
- Verify that the notification appears in the configured Discord channel
- Confirm that the message format is correct
Troubleshooting
Bot not appearing on the server
- Check that you have administrative permissions on the server
- Try reinstalling the bot using the authorization URL
Messages not sent
- Confirm that the channel ID is correct
- Check the bot's permissions in the channel
- Make sure the webhook is enabled in the API
Bot without permissions
- Access the channel settings
- Add the necessary permissions manually
- Or adjust the bot's role permissions on the server
Important Notes
- The channel ID is unique and specific to each channel
- Permissions can be inherited from the server settings
- Keep the channel ID secure, as it grants access to the specific channel
- The bot will only work on servers where it has been authorized
Tip: For a quick test, you can send a manual message in the channel and check if the bot can "see" the message using the configured permissions.