# Discord Webhook Notifications

Introduced in v1.0.1-RELEASE, this integration can send discord webhooks whenever Sentry captures something.

In other words, whenever the plugin notifies admins, it will send the exact same notification to a custom Discord Webhook as well.

This is useful if you want to add an extra layer of care to your server and get notified on Discord along with the game.

***

## Configuration

As every other Integration, it is located inside the integrations.yml file.

### Settings

The settings section is where you can modify some values to suit your needs.

Firstly, you need to set the `webhook-url` to your Discord Webhook link.

***

## Creating and getting a Discord Webhook link

First, head to the discord channel where you want your notifications to be sent.

1. Click on edit channel
2. Go to "Integrations"

<div align="left"><figure><img src="https://3906492514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5A1c7acpZklUlMeiNkyO%2Fuploads%2FIZN6arv8X9k0jfehgHi4%2Fimage.png?alt=media&#x26;token=160d586d-46f7-4468-9f5f-e5bb9d2c1762" alt=""><figcaption></figcaption></figure></div>

3. Click on the large blue button "Create Webhook"

<div align="left"><figure><img src="https://3906492514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5A1c7acpZklUlMeiNkyO%2Fuploads%2FTzBKli3I9gfJUCbhut5h%2Fimage.png?alt=media&#x26;token=f143d743-e018-4c49-b5f1-3ce98be8417b" alt=""><figcaption></figcaption></figure></div>

4. Select your newly created Webhook
5. Customize it as much as you want. Sentry will use your Webhook profile options to send the notifications.
6. Click on the large grey button "Copy Webhook URL"

<div align="left"><figure><img src="https://3906492514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5A1c7acpZklUlMeiNkyO%2Fuploads%2FapWnGA2EsLCgcatkj71y%2Fimage.png?alt=media&#x26;token=7c5fc83e-b42e-437a-9e67-188774fc2e28" alt=""><figcaption></figcaption></figure></div>

7. Go back to the integrations.yml file, and paste the URL inside the `webhook-url`
8. **Make sure** you enabled the Discord integration.

<div align="left"><figure><img src="https://3906492514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5A1c7acpZklUlMeiNkyO%2Fuploads%2FJs88SE6KACtKTr127Kn5%2Fimage.png?alt=media&#x26;token=abe778aa-9227-4de4-8ab0-1b46f19c241e" alt=""><figcaption></figcaption></figure></div>

9. Restart your server.

***

## Default file & values

<details>

<summary>Default file &#x26; values</summary>

```yaml
# Discord webhook integration
# Sends a message to the specified webhook evertime Sentry catches something.
# In other words, everytime the plugin notifies the admins, will send the same notification to Discord aswell.
discord:
  # If true, enables the discord webhook integration
  enabled: false

  # Sends a webhook notification when the plugin starts. Will ignore the "settings content" and send just the webhook. Default: true
  notify-on-enable: true

  # Webhook Settings, here you can modify the values, remember to copypaste the webhook URL here when you create it on your discord channel!
  settings:
    webhook-url: "" # Set the webhook URL here
    content: "@everyone" # Here you can set any content to be sent alongside the embed, useful when you want to mention someone or some role.
```

</details>
