Channel specifics help page

Email

For email, it is necessary to set the username, password and domain of the email from which the emails will be sent, the rest is optional. It is possible to set the port and smtp server, if it is not set, apprise will try to discover it automatically. The e-mails to which the notifications will be sent are set in the to email box. If it is left empty, notifications will go to the email that sends them. The remaining fields are explained in the apprise documentation(link). 

In the boxes where you can enter multiple emails, you must separate the emails with a comma without a space.

Slack

For Slack notifications to work, in addition to the settings, it is necessary to create a bot that will actually send them.

  1. On this link, select "From scratch", fill in the name of the bot and select the workspace where it should send messages. Click "Create app".
  2. In the left menu, go to "Features -> OAuth & permissions
  3. Under "Scopes -> Bot token scopes" click on "Add an OAuth Scope" and add "chat:write" and "files:write".
  4. Above, under "OAuth Tokens for Your Workspace", click "Install to Workspace" and then "Allow". With this, you have installed the app in the workspace.
  5. Last, just click on "copy" under "OAuth Tokens for Your Workspace -> Bot User OAuth Token". This is the token for channel settings.

In settings the token field is for the token you just created. Slack channels defines which channels the bot will send notifications to. In addition to the settings, however, it is also necessary to invite the bot to these channels in the workspace (/invite @BOT_NAME).

Discord

Setting up discord notifications is very simple, just choose a channel, create a webhook for it and put its url in the config. You can create a webhook in the channel settings, in the integration section.

It is possible to enter multiple webhooks, in which case they must be separated by a comma without a space.

MS Teams

Setting up notifications in MS teams is very simple, just choose a channel, create a webhook for it and put its url in the config. You create a webhook by selecting a channel and clicking on more options at the top of the navigation panel. Search for incoming webhook and press add.

It is possible to enter multiple webhooks, in which case they must be separated by a comma without a space.

Telegram

To send messages via Telegram, it is necessary to create a bot that will actually send them. First of all, it is necessary to open communication with BotFather. Then you need to write "/newbot" in his chat, here you fill in the name of the bot and a unique username. After filling it out correctly, BotFather will provide you with a token for our config.

Once you have created a bot, we need to know where will the bot send messages to (chat id). Unfortunately, Telegram does not have a direct way to find out chat id, so for every chat, you need to add the bot and send a message (just send a message to the bot if you want him to send messages directly to you). Subsequently, it is necessary to visit "https://api.telegram.org/bot{bot_token}/getUpdates" where you will see a log of received messages. Here you can view individual messages, sender info and chat info where you can find chat id which you will use in our config.

Practically, the scenario of using Telegram bot is as follows:

  1. We assume that you have already created a bot and you know its token
  2. Create a new group in the Telegram application
  3. Add the bot to the group, if you created the bot using BotFather, you also specified its name. So, according to this name, you can search and add to the group as a Member
  4. Send the bot a message directly in the chat of this group. Start writing by stating e.g. @NameOfBot message
  5. Now open https://api.telegram.org/bot{bot_token}/getUpdates in your browser
  6. json will be displayed to you, as shown in the image below, and in the "message" section you will see "chat" and the id of this chat. Since it is a group, the identifier should be a negative number.
  7. This whole number is "chat id" and you will use it in the application as "chat id"
  8. To check in the application, press the "Test" button, which is located in the upper part above the name of this Telegram channel.
  9. A new tab will open where you can edit the message and press "Run".
  10. Almost immediately, you should see the message in the Telegram application in the new group.
  11. Don't forget to save the following changes using the "Save" button

TIP: It is possible to enter multiple chat_ids, in which case it is necessary to separate them with a comma without a space.

Telegram chat id