SendTelegram

> [HTML Version](sendtelegramgroup.html)

Важно\! Если требуется отправить Telegram сообщение одному или нескольким произвольным пользователям, то используйте отдельный метод [SendTelegram](sendtelegram.md).

**Синтаксис**

````
function SendTelegram(const AMessage: string; const AMode: TM\_TelegramParseMode = tpmNone; const ASound: Boolean = TRUE): TM\_Telegram;

````
**Описание**

Функция доступна во всех версиях, за исключением Minimal и Demo-64. Для отправки Telegram-сообщений необходимо предварительно настроить параметры отправки через "Options.exe" -> раздел "Simple-Scada Server" -> "Отправка Telegram-сообщений". Подробнее о настройке см. раздел "[Настройка Telegram-сообщений](https://simple-scada.com/help/manual/index.html?telegramset.html)". 

Отправляет сообщение через Telegram всем [пользователям группы](https://simple-scada.com/help/manual/newusergroup.html), в [профиле](https://simple-scada.com/help/manual/new-user.html) которых заполнено поле "Telegram" (не равно 0). Если пользователь [заблокирован](https://simple-scada.com/help/manual/usermanag.html?anchor=actpanel), то ему не будет отправлено Telegram сообщение. К сообщению можно прикреплять вложения и отчеты. Возвращает nil, если в группе нет пользователей для отправки или если при попытке создания сообщения возникла ошибка. Получить имя группы пользователей можно через меню "[Пользователи -> Редактировать](https://simple-scada.com/help/manual/editor-users.html)" - см. параметр "[Имя в скриптах](https://simple-scada.com/help/manual/newusergroup.html?anchor=basicset)". 

| **Параметр** | **Описание** |
|------|------|
| AMessage | Текст сообщения |
| AMode | Необязательный параметр. Определяет тип разметки. Имеет тип [TM\_TelegramParseMode](tmtelegramparsemode.md). Telegram поддерживает ограниченное HTML/Markdown форматирование. Подробнее о форматировании сообщений в Telegram можно прочесть в документации Telegram: [Markdown разметка](https://core.telegram.org/bots/api#markdown-style), [HTML разметка](https://core.telegram.org/bots/api#html-style). |
| ASound  | Необязательный параметр. Определяет, нужно ли выдавать звуковой сигнал при получении сообщения. |


**Пример кода**

**(./images/tog_code_1.png) 1. Отправка Telegram-сообщения для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendtelegramgroup.html?anchor=ex1)**

````
begin  
  // отправка Telegram-сообщения всем пользователям группы ugOperators  
  ugOperators.SendTelegram('Авария котла\!');                   
end.
````

````
**(./images/tog_code_1.png) 2. Отправка Telegram-сообщения с вложением для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendtelegramgroup.html?anchor=ex2)**

````
var  
  aTelegram: TM\_Telegram;  
begin  
  // создаем Telegram-сообщение для отправки всем пользователям группы ugOperators  
  aTelegram := ugOperators.SendTelegram('Руководство');    
  
  if aTelegram <> nil then                     // если сообщение успешно создано,  
    aTelegram.AttachFile('E:\\Manual.pdf');     // то прикрепляем файл "Manual.pdf"  
end.
````

````
**(./images/tog_code_1.png) 3. Отправка Telegram-сообщения с отчетом для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendtelegramgroup.html?anchor=ex3)**

````
var  
  aReport: TM\_Report;  
  aTelegram: TM\_Telegram;  
begin  
  aReport := ReportBuild('Отчет');  // строим отчет  
  
  // создаем Telegram-сообщение для отправки всем пользователям группы ugOperators  
  aTelegram := ugOperators.SendTelegram('');         
  if aTelegram <> nil then                         // если сообщение успешно создано,  
    aTelegram.AttachReport(aReport, 'Мой отчет');  // то прикрепляем к нему отчет с именем "Мой отчет"  
end.
````

````
****