Skip to content

Commit 43a2f8c

Browse files
authored
Update DiscordIntegration.md - bot vs webhook
1 parent a60058a commit 43a2f8c

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

Wiki/Software/DiscordIntegration.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,16 @@ The Computer-Programs application can integrate with Discord. These can be usefu
1515
- [Discord Webhook Notifications](DiscordWebhooks.md)
1616
- [Discord Bot Integration](DiscordBot.md)
1717

18+
# Bot vs Webhook
19+
When setting up Discord integration, you have the option of setting up a bot or a webhook. Both can send notifications, but do so differently.
1820

21+
A webhook is a URL. You (or anyone else that knows the URL) can make a POST request to that URL and then Discord will send the contents of that request as a message in the webhook's channel. This is all that webhooks can do. They can do nothing else except send a message in one specific channel. Webhooks are not restricted by permissions; making a valid request to the hook will always result in a message, there's no way to prevent that.
1922

23+
Bots are actual users in Discord, more or less the same as human users. They join your server and then show up in the server's member list. Bots have access to Discord's entire API and can do basically the same things a human can do. Meaning they can send/read/delete/pin messages, create/delete/assign roles, create/delete/edit channels, kick/ban members, all that jazz. They are subject to the same permission system as normal users, so you can use permissions to regulate what a specific bot is allowed to do.
24+
25+
Messages sent by webhooks have more formatting options. You can use named links embeds inside the regular message content instead of just inside embeds, and you can send multiple embeds in one message. With webhooks you can also choose a different username and avatar for each message, while bots, just like humans, have one username and avatar that consistently shows up with every message.
26+
27+
If you want to live-host on a server, most servers (including us and SHA) require a bot instead of a webhook even though all it does is post notifications. Since webhooks are not restricted by permissions, they are a security vulnerability. (the webhook can @everyone with spam or other inappropriate content).
2028

2129
<hr>
2230

@@ -25,3 +33,4 @@ The Computer-Programs application can integrate with Discord. These can be usefu
2533
[<img src="https://canary.discordapp.com/api/guilds/695809740428673034/widget.png?style=banner2">](https://discord.gg/cQ4gWxN)
2634

2735

36+

0 commit comments

Comments
 (0)