Бот Telegram: различия между версиями
Дым (обсуждение | вклад) |
Дым (обсуждение | вклад) |
||
(не показано 25 промежуточных версий этого же участника) | |||
Строка 3: | Строка 3: | ||
А меж тем всё довольно просто. | А меж тем всё довольно просто. | ||
=Получение бота= | =Получение бота= | ||
Cгенерим нового телегобота в | Cгенерим нового телегобота в генераторе (внезапно!) телегоботов, для чего следует: | ||
#Отправить боту-праотцу [https://t.me/BotFather @BotFather] молитву '''<code>/newbot</code>'''. | #Отправить боту-праотцу [https://t.me/BotFather @BotFather] молитву '''<code>/newbot</code>'''. | ||
#Ввести название бота — в этой категории особых ограничений нет. | #Ввести название бота — в этой категории особых ограничений нет. | ||
Строка 10: | Строка 10: | ||
#*написано латиницей, | #*написано латиницей, | ||
#*оканчиваться на '''bot''' ''(так Телега защищается от злыдней, выдающих ботов за людей... замуж)''. | #*оканчиваться на '''bot''' ''(так Телега защищается от злыдней, выдающих ботов за людей... замуж)''. | ||
По завершению сего действа праотец пришлет токен-жетон нового бота в виде: <pre><10- | По завершению сего действа праотец пришлет токен-жетон нового бота в виде: <pre><10-циферный ИД бота>:ХХХ-<31-цифробуквенный жетон></pre>Каковой в дальнейшем и задействуем. | ||
{{Внимание|Токен бота (тот, что после двоеточия) храним пуще зеницы ока, поскольку всяк, кому оный вéдом, может невозбранно слать непотребства от добавленного в чат имени того!}} | {{Внимание|Токен бота (тот, что после двоеточия) храним пуще зеницы ока, поскольку всяк, кому оный вéдом, может невозбранно слать непотребства от добавленного в чат имени того!}} | ||
=Группы-чаты-каналы= | =Группы-чаты-каналы= | ||
Добавив свежеиспечённого бота в скопления людей, куда хочется слать мессаги, следует получить ИДы этих групп. Что легко достижимо копированием ссылки на любое сообщение в нужной группе. | Добавив свежеиспечённого бота в скопления людей, куда хочется слать мессаги, следует получить ИДы этих групп ( {{path|https://t.me/<ВОТ ЭТА ЧАСТЬ>/}}). Что легко достижимо копированием ссылки на любое сообщение в нужной группе. | ||
Например: | |||
==Сообщение из темы про Альт в публичном чате== | |||
<pre>https://t.me/linuxforum_ru/685/ZZZZ</pre> | <pre>https://t.me/linuxforum_ru/685/ZZZZ</pre> | ||
Здесь: | Здесь: | ||
*linuxforum_ru — ИД группы/чата | |||
*685 — (не обязательный) ИД темы, | *685 — (не обязательный) ИД темы, | ||
*ZZZZ — (ненужный) ИД сообщения. | *ZZZZ — (ненужный) ИД сообщения. | ||
Или в какой-нибудь частной группе | ==Или в какой-нибудь частной группе== | ||
<pre>https://t.me/XXXXXXXXXX/YYYY/ZZZZ</pre> | <pre>https://t.me/XXXXXXXXXX/YYYY/ZZZZ</pre> | ||
*-100+XXXXXXXXXX — ИД чата ('''-100XXXXXXXXXX'''), | *-100+XXXXXXXXXX — ИД группы/чата ('''-100XXXXXXXXXX'''), | ||
*YYYY — ИД темы. | *YYYY — ИД темы. | ||
=Отправка сообщений= | =Отправка сообщений= | ||
Внесём в баш-скрипт команду ''(удобнее оформить как функцию — см. в | Внесём в баш-скрипт команду ''(удобнее оформить как функцию — см. в примере ниже)'', которая при наступлении отслеживаемого события будет слать соответствующий текст по жетону бота и ИДу канала (и темы, если надо) ''(на куски разбито для удобочитаемости, можно одной строкой)'': | ||
<pre> | <pre> | ||
$ curl -s https://api.telegram.org/bot<Токен>/send<Функция> \ | $ curl -s https://api.telegram.org/bot<Токен>/send<Функция> \ | ||
Строка 37: | Строка 40: | ||
*либо <code>Message</code> — тогда поле <code>"text=..."</code>, | *либо <code>Message</code> — тогда поле <code>"text=..."</code>, | ||
*либо <code>Document</code> — тогда поле <code>"document=@..."</code>. | *либо <code>Document</code> — тогда поле <code>"document=@..."</code>. | ||
Адрес и поля <code>-F "..."</code> можно размещать в любом порядке и в одну строку. | Адрес, опции (<code>-s</code>, например) и поля <code>-F "..."</code> можно размещать в любом порядке и в одну строку. | ||
=Пример | {|class="mw-collapsible mw-collapsed wikitable" | ||
!Пример распаковки дампа базы для проверки | |||
<source lang=bash> | |- | ||
|<source lang=bash> | |||
#!/bin/bash | #!/bin/bash | ||
Token="10_цифр:???-31_цифробуква" # Токен/жетон созданного для этого бота. | Token="10_цифр:???-31_цифробуква" # Токен/жетон созданного для этого бота. | ||
URL="https://api.telegram.org/bot$Token" # API телеги с ИДом бота. | URL="https://api.telegram.org/bot$Token" # API телеги с ИДом бота. | ||
Строка 52: | Строка 53: | ||
Topic="<ИД темы>" # Например, в тему "Дампы БД". | Topic="<ИД темы>" # Например, в тему "Дампы БД". | ||
WD=/mnt/dumps.psql/daily # Ежедневные дампы на СХД. | |||
DUMP=`ls -1 $WD/$1*|tail -2|head -1|sed 's|.*/||'` # Проверять предпоследнюю ежедневку. | |||
} | DATE=${DUMP%,*} # Дампы имеют вид 'база,гггг-мм-дд,чч-мм-сс.тип' | ||
TEST=check_${DUMP%%,*} # Имя базы для проверки бэкапа. | |||
case ${DUMP##*.} in | case ${DUMP##*.} in | ||
zst) UNPAK=zstdcat | lzo) UNPAK="lzop -dcf";; | ||
zst) UNPAK="zstdcat" ;; | |||
sql) UNPAK="cat" ;; | |||
esac | esac | ||
Notify(){ # Функция отправки оповещений из предварительно сформированного текста. | |||
curl -F "chat_id=$ChatID" -F "reply_to_message_id=$Topic" \ | |||
-F "text=$1" -s $URL/sendMessage 2>&1 >/dev/null | |||
} | |||
Notify " | Notify "(Пере)создаётся база $TEST." | ||
[ `psql -U postgres -c "\l+ $TEST" | grep -c $TEST` -eq 0 ] || { | |||
[ `psql -U postgres -c "\l+" | grep -c $ | for pid in `psql -U postgres -c 'SELECT datname, pid FROM pg_stat_activity' | | ||
for | awk '/'$TEST'/{print $3}'`; do | ||
psql -U postgres -c "SELECT pg_terminate_backend($pid);" | |||
done | done | ||
# | dropdb -U postgres $TEST | ||
$UNPAK $WD/$DUMP | psql -U postgres -d $ | } | ||
createdb -U postgres $TEST || { | |||
Notify "Пересоздать не удалось: база занята." | |||
exit | |||
} | |||
Notify "Распаковывается база $TEST от ${DATE#*,}." | |||
$UNPAK $WD/$DUMP | psql -U postgres -d $TEST >/dev/null 2>&1 | |||
TIME=$(date +%T -ud @$[`date +%s`-START]) # Сколько длился весь процесс. | TIME=$(date +%T -ud @$[`date +%s`-START]) # Сколько длился весь процесс. | ||
Notify "$ | Notify "$TEST распакована за $TIME, можно проверять целостность." | ||
</source> | </source> | ||
|} | |||
=Обратная связь= | =Обратная связь= |
Текущая версия от 18:25, 17 января 2024
Многие ищут способы отправлять оповещения о событиях на инфраструктуре в свои телеграм-группы/чаты — изучают перл с питоном (дело хорошее, но необязательное) да роются по гит-барахолкам в поисках телегоботов, написанных другими.
А меж тем всё довольно просто.
Получение бота
Cгенерим нового телегобота в генераторе (внезапно!) телегоботов, для чего следует:
- Отправить боту-праотцу @BotFather молитву
/newbot
. - Ввести название бота — в этой категории особых ограничений нет.
- Задать техническое имя бота, которое будет отображаться в адресной строке. К нему есть требования — оно должно:
- быть уникальным,
- написано латиницей,
- оканчиваться на bot (так Телега защищается от злыдней, выдающих ботов за людей... замуж).
По завершению сего действа праотец пришлет токен-жетон нового бота в виде:
<10-циферный ИД бота>:ХХХ-<31-цифробуквенный жетон>
Каковой в дальнейшем и задействуем.
Группы-чаты-каналы
Добавив свежеиспечённого бота в скопления людей, куда хочется слать мессаги, следует получить ИДы этих групп ( https://t.me/<ВОТ ЭТА ЧАСТЬ>/). Что легко достижимо копированием ссылки на любое сообщение в нужной группе.
Например:
Сообщение из темы про Альт в публичном чате
https://t.me/linuxforum_ru/685/ZZZZ
Здесь:
- linuxforum_ru — ИД группы/чата
- 685 — (не обязательный) ИД темы,
- ZZZZ — (ненужный) ИД сообщения.
Или в какой-нибудь частной группе
https://t.me/XXXXXXXXXX/YYYY/ZZZZ
- -100+XXXXXXXXXX — ИД группы/чата (-100XXXXXXXXXX),
- YYYY — ИД темы.
Отправка сообщений
Внесём в баш-скрипт команду (удобнее оформить как функцию — см. в примере ниже), которая при наступлении отслеживаемого события будет слать соответствующий текст по жетону бота и ИДу канала (и темы, если надо) (на куски разбито для удобочитаемости, можно одной строкой):
$ curl -s https://api.telegram.org/bot<Токен>/send<Функция> \ -F "text=Нужное сообщение." \ -F "document=@/путь/к/файлу" \ -F "chat_id=-100ХХХХХХХХХХ" \ -F "reply_to_message_id=YYYY"
Где Функция:
- либо
Message
— тогда поле"text=..."
, - либо
Document
— тогда поле"document=@..."
.
Адрес, опции (-s
, например) и поля -F "..."
можно размещать в любом порядке и в одну строку.
Пример распаковки дампа базы для проверки |
---|
#!/bin/bash
Token="10_цифр:???-31_цифробуква" # Токен/жетон созданного для этого бота.
URL="https://api.telegram.org/bot$Token" # API телеги с ИДом бота.
ChatID="-13_цифр" # ИД чатика, куда слать оповещения.
Topic="<ИД темы>" # Например, в тему "Дампы БД".
WD=/mnt/dumps.psql/daily # Ежедневные дампы на СХД.
DUMP=`ls -1 $WD/$1*|tail -2|head -1|sed 's|.*/||'` # Проверять предпоследнюю ежедневку.
DATE=${DUMP%,*} # Дампы имеют вид 'база,гггг-мм-дд,чч-мм-сс.тип'
TEST=check_${DUMP%%,*} # Имя базы для проверки бэкапа.
case ${DUMP##*.} in
lzo) UNPAK="lzop -dcf";;
zst) UNPAK="zstdcat" ;;
sql) UNPAK="cat" ;;
esac
Notify(){ # Функция отправки оповещений из предварительно сформированного текста.
curl -F "chat_id=$ChatID" -F "reply_to_message_id=$Topic" \
-F "text=$1" -s $URL/sendMessage 2>&1 >/dev/null
}
Notify "(Пере)создаётся база $TEST."
[ `psql -U postgres -c "\l+ $TEST" | grep -c $TEST` -eq 0 ] || {
for pid in `psql -U postgres -c 'SELECT datname, pid FROM pg_stat_activity' |
awk '/'$TEST'/{print $3}'`; do
psql -U postgres -c "SELECT pg_terminate_backend($pid);"
done
dropdb -U postgres $TEST
}
createdb -U postgres $TEST || {
Notify "Пересоздать не удалось: база занята."
exit
}
Notify "Распаковывается база $TEST от ${DATE#*,}."
$UNPAK $WD/$DUMP | psql -U postgres -d $TEST >/dev/null 2>&1
TIME=$(date +%T -ud @$[`date +%s`-START]) # Сколько длился весь процесс.
Notify "$TEST распакована за $TIME, можно проверять целостность."
|