Compare commits
1 Commits
update-sub
...
configureD
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
35107c0a9d |
77
README.md
77
README.md
@@ -144,7 +144,82 @@ To receive alerts via Telegram, you need to create a bot and get your chat ID.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
*Guides for Discord, Slack, and Email coming soon.*
|
### Discord
|
||||||
|
|
||||||
|
To receive alerts in a Discord channel, you need to create a webhook.
|
||||||
|
|
||||||
|
#### 1. Create a Discord Webhook
|
||||||
|
|
||||||
|
1. Open **Discord** and navigate to the server where you want to receive alerts.
|
||||||
|
2. Go to the channel you want alerts posted in (or create a new one, e.g. `#koin-alerts`).
|
||||||
|
3. Click the **gear icon** next to the channel name to open **Channel Settings**.
|
||||||
|
4. Go to **Integrations** > **Webhooks**.
|
||||||
|
5. Click **New Webhook**.
|
||||||
|
6. Give it a name (e.g. `Koin Ping`) and click **Copy Webhook URL**.
|
||||||
|
|
||||||
|
The URL will look like: `https://discord.com/api/webhooks/123456789/AbCdEfGhIjKl...`
|
||||||
|
|
||||||
|
#### 2. Save in Koin Ping
|
||||||
|
|
||||||
|
1. Go to the **Alerts** page in Koin Ping.
|
||||||
|
2. In the **Notification Settings** panel, find the **Discord** section.
|
||||||
|
3. Paste your **Webhook URL** into the field.
|
||||||
|
4. Click **Save Settings**.
|
||||||
|
5. Click **Test All Channels** to verify — you should see a test message appear in your Discord channel.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Slack
|
||||||
|
|
||||||
|
To receive alerts in a Slack channel, you need to create an Incoming Webhook.
|
||||||
|
|
||||||
|
#### 1. Create a Slack App with Incoming Webhooks
|
||||||
|
|
||||||
|
1. Go to [https://api.slack.com/apps](https://api.slack.com/apps) and click **Create New App**.
|
||||||
|
2. Choose **From scratch**, give it a name (e.g. `Koin Ping`), and select your workspace.
|
||||||
|
3. In the app settings, go to **Incoming Webhooks** in the left sidebar.
|
||||||
|
4. Toggle **Activate Incoming Webhooks** to **On**.
|
||||||
|
5. Click **Add New Webhook to Workspace**.
|
||||||
|
6. Select the channel where you want alerts posted (e.g. `#koin-alerts`) and click **Allow**.
|
||||||
|
7. Copy the **Webhook URL** — it will start with `https://hooks.slack.com/services/...`
|
||||||
|
|
||||||
|
#### 2. Save in Koin Ping
|
||||||
|
|
||||||
|
1. Go to the **Alerts** page in Koin Ping.
|
||||||
|
2. In the **Notification Settings** panel, find the **Slack** section.
|
||||||
|
3. Paste your **Webhook URL** into the field.
|
||||||
|
4. Click **Save Settings**.
|
||||||
|
5. Click **Test All Channels** to verify — you should see a test message appear in your Slack channel.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Email
|
||||||
|
|
||||||
|
Koin Ping sends email alerts and digests via [Resend](https://resend.com). To enable email notifications, the application owner must configure a Resend account and verified sending domain.
|
||||||
|
|
||||||
|
#### For Application Owners (Deployment Setup)
|
||||||
|
|
||||||
|
1. Create an account at [resend.com](https://resend.com).
|
||||||
|
2. Go to [resend.com/domains](https://resend.com/domains) and add your sending domain.
|
||||||
|
3. Add the DNS records Resend provides (SPF, DKIM, etc.) to your domain's DNS settings.
|
||||||
|
4. Once verified, create an API key at [resend.com/api-keys](https://resend.com/api-keys).
|
||||||
|
5. Set the following in your `.env` file:
|
||||||
|
|
||||||
|
```
|
||||||
|
RESEND_API_KEY=re_your_api_key_here
|
||||||
|
EMAIL_FROM=Your App <alerts@yourdomain.com>
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Restart the API server and poller to pick up the changes.
|
||||||
|
|
||||||
|
#### For Users
|
||||||
|
|
||||||
|
1. Go to the **Alerts** page in Koin Ping.
|
||||||
|
2. In the **Notification Settings** panel, find the **Email** section.
|
||||||
|
3. Enter the email address where you want to receive alerts.
|
||||||
|
4. Click **Save Settings**.
|
||||||
|
5. Click **Verify Email** to receive a confirmation message.
|
||||||
|
6. Click **Test All Channels** to verify — you should receive a test alert at your email address.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user