SendTelegram

> [HTML Version](sendtelegramuser.html)

Важно\! Если требуется отправить Telegram сообщение на произвольный ChatID, то используйте отдельный метод [SendTelegram](sendtelegram.md). Если требуется отправить Telegram сообщение [группе пользователей](https://simple-scada.com/help/manual/newusergroup.html), то используйте метод [SendTelegram](sendtelegramgroup.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-сообщений](https://simple-scada.com/help/manual/index.html?telegramset.html)".

Отправляет Telegram сообщение пользователю, [созданному через редактор](https://simple-scada.com/help/manual/new-user.html), если в его профиле заполнено поле "Telegram" (не равно 0). Если пользователь [заблокирован](https://simple-scada.com/help/manual/usermanag.html?anchor=actpanel), то ему не будет отправлено Telegram сообщение. К сообщению можно прикреплять вложения и отчеты. Возвращает nil, если Telegram пользователя не задан, или если при попытке создания сообщения возникла ошибка. Получить имя пользователя можно через меню "[Пользователи -> Редактировать](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/sendtelegramuser.html?anchor=ex1)**

````
begin  
  // отправка Telegram-сообщения пользователю usAdmin  
  usAdmin.SendTelegram('Авария котла\!');                   
end.
````

````
**(./images/tog_code_1.png) 2. Отправка пользователю Telegram-сообщения с вложением [(./images/link.png)](https://simple-scada.com/help/script/sendtelegramuser.html?anchor=ex2)**

````
var  
  aTelegram: TM\_Telegram;  
begin  
  // создаем сообщение для отправки пользователю usAdmin  
  aTelegram := usAdmin.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/sendtelegramuser.html?anchor=ex3)**

````
var  
  aReport: TM\_Report;  
  aTelegram: TM\_Telegram;  
begin  
  aReport := ReportBuild('Отчет');  // строим отчет  
  
  // создаем сообщение для отправки пользователю usAdmin   
  aTelegram := usAdmin.SendTelegram('');             
  if aTelegram <> nil then                         // если сообщение успешно создано,  
    aTelegram.AttachReport(aReport, 'Мой отчет');  // то прикрепляем к нему отчет с именем "Мой отчет"  
end.
````

````
****