diff --git a/docs/sources/open-source/_index.md b/docs/sources/open-source/_index.md index c0c92316..2abce683 100644 --- a/docs/sources/open-source/_index.md +++ b/docs/sources/open-source/_index.md @@ -44,7 +44,9 @@ To update an OSS installation of Grafana OnCall, please see the update docs: The Slack integration for Grafana OnCall leverages Slack API features to provide a customizable and useful integration. Refer to the following steps to configure the Slack integration: -1. Ensure your Grafana OnCall environment is up and running. +1. Ensure your Grafana OnCall environment is up and running + +1. Set `FEATURE_SLACK_INTEGRATION_ENABLED` as True 1. Grafana OnCall must be accessible through HTTPS. For development purposes, use [localtunnel](https://github.com/localtunnel/localtunnel). For production purposes, consider establishing a proper web server with HTTPS termination. @@ -175,18 +177,23 @@ settings: ## Telegram Setup + + The Telegram integration for Grafana OnCall is designed for collaborative team work and improved incident response. Refer to the following steps to configure the Telegram integration: 1. Ensure your Grafana OnCall environment is up and running. -2. Create a Telegram bot using [BotFather](https://t.me/BotFather) and save the token provided by BotFather. Please make +2. Set `FEATURE_TELEGRAM_INTEGRATION_ENABLED` as "True" +3. Create a Telegram bot using [BotFather](https://t.me/BotFather) and save the token provided by BotFather. Please make sure to disable **Group Privacy** for the bot (Bot Settings -> Group Privacy -> Turn off). -3. Paste the token provided by BotFather to the `TELEGRAM_TOKEN` variable on the **Env Variables** page of your +4. Paste the token provided by BotFather to the `TELEGRAM_TOKEN` variable on the **Env Variables** page of your Grafana OnCall instance. -4. Set the `TELEGRAM_WEBHOOK_HOST` variable to the external address of your Grafana OnCall instance. Please note +5. Set the `TELEGRAM_WEBHOOK_HOST` variable to the external address of your Grafana OnCall instance. Please note that `TELEGRAM_WEBHOOK_HOST` must start with `https://` and be publicly available (meaning that it can be reached by Telegram servers). If your host is private or local, consider using a reverse proxy (e.g. [ngrok](https://ngrok.com)). -5. Now you can connect Telegram accounts on the **Users** page and receive alert groups to Telegram direct messages. +6. Now you can connect Telegram accounts on the **Users** page and receive alert groups to Telegram direct messages. Alternatively, in case you want to connect Telegram channels to your Grafana OnCall environment, navigate to the **ChatOps** tab.