===== Notification Groups =====


Notification groups describe how the messages and alarms will be delivered to users.

There are the following ways:
  * Email: the message will be delilvered through the smtp relay server to the user’s email address or to a specific email address
  * SMS: the message will be delilvered through the sms proxy server to the user’s phone or to a specific phone number
  * Telegram: the message will be delilvered to a specific Telegram user account



===== Telegram Notifications =====

The steps to create a Telegram Notification are:
  - Create a channel to Telegram and a bot
  - Configure the channel to NeMo
  - Create the Notification group
  - Testing the notification group


==== Create a channel to Telegram and a bot ====

  * //Fisrt step// is to create a channel. Telegram members will join to the channel to read the Telegram nofitication sent by NeMo through the bot ([[https://telegram.org/faq_channels]]). For more information about bot please visit [[https://core.telegram.org/bots]]

  * //Second step// is to create a bot to add as administrator member of the channel. Open Telegram BotFather and create the bot with the command **/start** and follow the instruction. Here is an example of a bot creation:

{{ :notification-telegram4.png?nolink&500 |}}

  * //Third step// add the bot to the channel.

  * //Fourth step// is retrieving the chat_id of the channel. With the NeMo shell (or any other linux machine) you need to find the chat_id related to the channel:

<code>
curl https://api.telegram.org/bot<ADD the Token here>/getUpdates?offset=0

{"ok":true,"result":[{"update_id":611548852,
"channel_post":{"message_id":2,"chat":{"id":**-1001148557862**,"title":"Channel-test","type":"channel"},"date":1499934011,"text":"/my_ip","entities":[{"type":"bot_command","offset":0,"length":6}]}}]}
</code>

In this case the chat id is: **-1001148557862**


==== Configure the channel to NeMo ====


  - On Admim tab, select Configuration/Notification Groups/Telegram Channels {{ :en:notification-telegram1.png?nolink&500 |}}
  - Click Add Channel and insert the Name of the channel that will be used on NeMo, the description, the chat identifier and the Bot Token {{ :en:notification-telegram2.png?nolink&400 |}}

==== Create the Notification group ====

  - Create a new notification group (Configuration/Notification Groups->Add Group) and save changes
  - Select the notification group and click Edit Group button {{ :en:notification-telegram3.png?nolink&400 |}}
  - select the tab Members and select Telegram as method
  - Select the Telegram channel



==== Testing the notification group ====

The administrator of the telegram group must add users that want to receive notification in the group, then select the notification group on NEMO and click **Send Test** button.

//Congratulations, you have created your Telegram Notification group!//