telegram-bot-bash/mycommands.sh

308 lines
11 KiB
Bash
Raw Normal View History

#!/bin/bash
2020-05-14 12:21:15 +00:00
#########
#
# files: mycommands.sh.dist
#
2020-08-01 07:10:14 +00:00
# this is an out of the box test and example file to show what's possible in mycommands.sh
2020-05-14 12:21:15 +00:00
#
2020-05-14 13:02:17 +00:00
# #### if you start to develop your own bot, use the clean version of this file:
2020-05-14 12:21:15 +00:00
# #### mycommands.clean
#
2020-11-29 14:34:00 +00:00
# shellcheck disable=SC1117
#### $$VERSION$$ v1.2-dev2-5-gda7a3f1
#
2019-04-24 11:40:59 +00:00
# uncomment the following lines to overwrite info and help messages
2020-08-08 09:39:02 +00:00
# use ${ME} for current bot name in messages
# Note: you must escape '_' in botname with two \ in markdown messages!
export bashbot_info='This is @'"${ME//_/\\\\_}"', the Telegram example bot written entirely in bash.
Edit commands and messages in mycommands.sh!
2020-08-08 09:39:02 +00:00
'
# export bashbot_help='*Available commands*:
#'
export res=""
2019-05-16 14:42:38 +00:00
# Set INLINE to 1 in order to receive inline queries.
# To enable this option in your bot, send the /setinline command to @BotFather.
export INLINE="0"
# Set to .* to allow sending files from all locations
2019-12-07 12:25:50 +00:00
# NOTE: this is a regex, not shell globbing! you must use a valid egex,
2020-06-23 14:35:50 +00:00
# '.' matches any character and '.*' matches all remaining charatcers!
2020-08-01 07:10:14 +00:00
# additionally you must escape special characters with '\', e.g. '\. \? \[ \*" to match them literally
export FILE_REGEX="${BASHBOT_ETC}/.*"
2020-06-11 06:33:59 +00:00
# set BASHBOT_RETRY to enable retry in case of recoverable errors, e.g. throtteling
2020-08-01 07:10:14 +00:00
# problems with send_xxx message etc are looged to logs/ERROR.log
2020-06-11 06:33:59 +00:00
unset BASHBOT_RETRY
#export BASHBOT_RETRY="yes"
2020-06-09 14:51:50 +00:00
2020-08-01 07:10:14 +00:00
# set value for adaptive sleeping while waiting for uodates in millisconds
2020-06-09 14:51:50 +00:00
# max slepp between polling updates 10s (default 5s)
export BASHBOT_SLEEP="10000"
2020-06-23 14:35:50 +00:00
# add 0.2s if no update available, up to BASHBOT_SLEEP (default 0.1s)
2020-06-09 14:51:50 +00:00
export BASHBOT_SLEEP_STEP="200"
2020-08-01 07:10:14 +00:00
# if you want to use timer functions, set BASHBOT_START_TIMER to a not empty value
# default is to not start timer
2020-06-09 14:51:50 +00:00
unset BASHBOT_START_TIMER
#export BASHBOT_START_TIMER="yes"
2020-08-01 07:10:14 +00:00
# set to "yes" and give your bot admin privilegs to remove service messages from groups
2020-05-14 13:02:17 +00:00
export SILENCER="no"
2020-08-01 07:10:14 +00:00
# uncomment to remove keyboards sent from your bot
2020-06-27 14:01:27 +00:00
# export REMOVEKEYBOARD="yes"
# export REMOVEKEYBOARD_PRIVATE="yes"
2020-08-01 07:10:14 +00:00
# uncomment to say welcome to new chat members
# export WELCOME_NEWMEMBER="yes"
WELCOME_MSG="Welcome"
2020-08-01 07:10:14 +00:00
# uncomment to be informed about new/left chat members
2020-07-12 11:59:59 +00:00
# export REPORT_NEWMEMBER="yes"
2020-07-12 13:18:11 +00:00
# export REPORT_LEFTMEMBER="yes"
2020-07-12 11:59:59 +00:00
2020-05-16 20:10:12 +00:00
# messages for admin only commands
NOTADMIN="Sorry, this command is allowed for admin or owner only"
NOTBOTADMIN="Sorry, this command is allowed for bot owner only"
2020-05-14 13:02:17 +00:00
2020-08-01 07:10:14 +00:00
########
# special network setup may require additional ARGS to curl
#
# example: run bashbot over TOR or SOCKS proxy
# export BASHBOT_CURL_ARGS="--socks5-hostname 127.0.0.1:9050" # TOR
# export BASHBOT_CURL_ARGS="--socks5-hostname 127.0.0.1" # regular SOCKS
2020-05-14 13:02:17 +00:00
if [ "$1" = "startbot" ];then
###################
2020-08-15 07:29:13 +00:00
# this section is processed on startup
# mark startup, triggers action on first message
2020-08-06 06:43:28 +00:00
setConfigKey "startupaction" "await"
2020-05-14 13:02:17 +00:00
else
#############################
# your own bashbot commands
2020-08-01 07:10:14 +00:00
# NOTE: command can have @botname attached, you must add * to case tests...
mycommands() {
2020-08-15 07:29:13 +00:00
#############
# action triggered on first message after startup
if [[ "$(getConfigKey "startupaction")" != "done"* ]]; then
# send message to first user on startup
send_normal_message "${CHAT[ID]}" "Hi, you are the first user after startup!"
2020-08-15 07:29:13 +00:00
# mark as done and when
setConfigKey "startupaction" "done $(date)"
fi
2020-05-14 13:02:17 +00:00
##############
# a service Message was received
2020-05-14 13:02:17 +00:00
# add your own stuff here
if [ -n "${SERVICE}" ]; then
2020-05-14 13:02:17 +00:00
# example: delete every service message
if [ "${SILENCER}" = "yes" ]; then
delete_message "${CHAT[ID]}" "${MESSAGE[ID]}"
fi
fi
2020-06-27 14:01:27 +00:00
# remove keyboard if you use keyboards
[ -n "${REMOVEKEYBOARD}" ] && remove_keyboard "${CHAT[ID]}" &
[[ -n "${REMOVEKEYBOARD_PRIVATE}" && "${CHAT[ID]}" == "${USER[ID]}" ]] && remove_keyboard "${CHAT[ID]}" &
2020-06-23 14:35:50 +00:00
# example for actions based on chat or sender
case "${USER[ID]}+${CHAT[ID]}" in
2020-11-29 14:34:00 +00:00
'USERID1+'*) # do something for all messages from USER
printf "%s: U=%s C=%s M=%s\n" "$(date)" "${USER[ID]}" "${CHAT[ID]}" "${MESSAGE}" >>"${DATADIR}/${USER[ID]}.log"
;;&
2020-11-29 14:34:00 +00:00
*'+CHATID1') # do something for all messages from CHAT
printf "%s: U=%s C=%s M=%s\n" "$(date)" "${USER[ID]}" "${CHAT[ID]}" "${MESSAGE}" >>"${DATADIR}/${CHAT[ID]}.log"
;;&
2020-11-29 14:34:00 +00:00
'USERID2+CHATID2') # do something only for messages form USER in CHAT
printf "%s: U=%s C=%s M=%s\n" "$(date)" "${USER[ID]}" "${CHAT[ID]}" "${MESSAGE}" >>"${DATADIR}/${CHAT[ID]}+${USER[ID]}.log"
;;&
esac
# fix first letter upper case because of smartphone auto correction
[[ "${MESSAGE}" =~ ^/[[:upper:]] ]] && MESSAGE="${MESSAGE:0:1}$(tr '[:upper:]' '[:lower:]' <<<"${MESSAGE:1:1}")${MESSAGE:2}"
2020-08-01 07:10:14 +00:00
# pre-check admin only commands
2020-05-16 20:10:12 +00:00
case "${MESSAGE}" in
# must be private, group admin, or botadmin
'/run_'*|'stop_'*)
send_action "${CHAT[ID]}" "typing"
if ! user_is_admin "${CHAT[ID]}" "${USER[ID]}" ; then
send_normal_message "${CHAT[ID]}" "${NOTADMIN}"; return 1
fi
# ok, now lets process the real command
;;
# must be botadmin
'/echo'*)
send_action "${CHAT[ID]}" "typing"
if ! user_is_botadmin "${USER[ID]}" ; then
send_markdown_message "${CHAT[ID]}" "*${NOTBOTADMIN}*"; return 1
fi
;;
# will we process edited messages also?
2020-06-29 13:39:03 +00:00
'/_edited_message'*)
return 1 # no
# but if we do, remove /edited_message
MESSAGE="${MESSAGE#/* }"
;;
'/_new_chat_member'*)
if [[ -n "${WELCOME_NEWMEMBER}" && "${NEWMEMBER[ISBOT]}" != "true" ]] && bot_is_admin "${CHAT[ID]}"; then
send_normal_message "${CHAT[ID]}"\
"${WELCOME_MSG} ${NEWMEMBER[FIRST_NAME]} ${NEWMEMBER[LAST_NAME]} (@${NEWMEMBER[USERNAME]})"
MYSENTID="${BOTSENT[ID]}"
{ sleep 5; delete_message "${CHAT[ID]}" "${MYSENTID}"; } &
2020-07-12 11:59:59 +00:00
[ -n "${REPORT_NEWMEMBER}" ] && send_normal_message "$(getConfigKey "botadmin")"\
2020-07-12 13:09:52 +00:00
"New member: ${CHAT[TITLE]} (${CHAT[ID]}): ${NEWMEMBER[FIRST_NAME]} ${NEWMEMBER[LAST_NAME]} (@${NEWMEMBER[USERNAME]})"
fi
;;
2020-07-12 13:18:11 +00:00
'/_left_chat_member'*)
[ -n "${REPORT_LEFTMEMBER}" ] && send_normal_message "$(getConfigKey "botadmin")"\
2020-08-04 06:31:38 +00:00
"Left member: ${CHAT[TITLE]} (${CHAT[ID]}): ${LEFTMEMBER[FIRST_NAME]} ${LEFTMEMBER[LAST_NAME]} (@${LEFTMEMBER[USERNAME]})"
2020-07-12 13:18:11 +00:00
;;
'/_migrate_group'*)
# call group migration function if provided
_exec_if_function my_migrate_group "${MIGRATE[FROM]}" "${MIGRATE[TO]}"
;;
2020-05-16 20:10:12 +00:00
esac
case "${MESSAGE}" in
2019-05-25 11:31:36 +00:00
##################
# example commands, replace thm by your own
'/echo'*) # example echo command
send_normal_message "${CHAT[ID]}" "$MESSAGE"
;;
2019-04-27 11:36:32 +00:00
'/question'*) # start interactive questions
checkproc
if [ "$res" -gt 0 ] ; then
startproc "examples/question.sh" || send_normal_message "${CHAT[ID]}" "Can't start question."
else
send_normal_message "${CHAT[ID]}" "$MESSAGE already running ..."
fi
;;
'/cancel'*) # cancel interactive command
checkproc
if [ "$res" -gt 0 ] ;then
killproc && send_normal_message "${CHAT[ID]}" "Command canceled."
else
send_normal_message "${CHAT[ID]}" "No command is currently running."
fi
;;
2019-05-01 17:21:57 +00:00
'/run_notify'*) # start notify background job
myback="notify"; checkback "$myback"
if [ "$res" -gt 0 ] ; then
background "examples/notify.sh 60" "$myback" || send_normal_message "${CHAT[ID]}" "Can't start notify."
else
send_normal_message "${CHAT[ID]}" "Background command $myback already running ..."
fi
;;
2019-05-01 17:21:57 +00:00
'/stop_notify'*) # kill notify background job
myback="notify"; checkback "$myback"
if [ "$res" -eq 0 ] ; then
killback "$myback"
send_normal_message "${CHAT[ID]}" "Background command $myback canceled."
else
send_normal_message "${CHAT[ID]}" "No background command $myback is currently running.."
fi
;;
2019-05-25 11:31:36 +00:00
##########
# command overwrite examples
'/info'*) # output date in front of regular info
2019-05-25 11:31:36 +00:00
send_normal_message "${CHAT[ID]}" "$(date)"
return 0
;;
'/kickme'*) # this will replace the /kickme command
send_markdown_mesage "${CHAT[ID]}" "*This bot will not kick you!*"
return 1
;;
esac
2019-05-02 10:33:10 +00:00
}
2019-05-09 21:34:45 +00:00
myinlines() {
#######################
2020-06-23 14:35:50 +00:00
# Inline query examples, do not use them in production (except image search ;-)
2019-05-09 21:34:45 +00:00
# shellcheck disable=SC2128
2019-05-10 19:38:25 +00:00
iQUERY="${iQUERY,,}" # all lowercase
2019-05-09 21:34:45 +00:00
case "${iQUERY}" in
2019-05-10 16:50:30 +00:00
"image "*) # search images with yahoo
2019-05-09 21:34:45 +00:00
local search="${iQUERY#* }"
answer_inline_multi "${iQUERY[ID]}" "$(my_image_search "${search}")"
;;
2019-05-10 16:50:30 +00:00
"0"*) # a single message with title
answer_inline_query "${iQUERY[ID]}" "message" "Title of the result" "Content of the message to be sent"
;;
"1"*) # a single photo
answer_inline_query "${iQUERY[ID]}" "photo" "https://avatars.githubusercontent.com/u/13046303" "https://avatars.githubusercontent.com/u/13046303"
;;
"2"*) # two photos
2019-05-09 21:34:45 +00:00
answer_inline_multi "${iQUERY[ID]}" "
2019-05-10 12:56:53 +00:00
$(inline_query_compose "$RANDOM" "photo" "https://avatars.githubusercontent.com/u/13046303"),
$(inline_query_compose "$RANDOM" "photo" "https://avatars.githubusercontent.com/u/4593242")
2019-05-09 21:34:45 +00:00
"
;;
2019-05-10 16:50:30 +00:00
"3"*) # three photos
answer_inline_multi "${iQUERY[ID]}" "
$(inline_query_compose "$RANDOM" "photo" "https://avatars.githubusercontent.com/u/13046303"),
$(inline_query_compose "$RANDOM" "photo" "https://avatars.githubusercontent.com/u/4593242")
$(inline_query_compose "$RANDOM" "photo" "https://avatars.githubusercontent.com/u/102707")
"
;;
2019-05-09 21:34:45 +00:00
2020-08-01 07:10:14 +00:00
"4") # four photos from array
2019-05-10 12:56:53 +00:00
local sep=""
local avatar=("https://avatars.githubusercontent.com/u/13046303" "https://avatars.githubusercontent.com/u/4593242" "https://avatars.githubusercontent.com/u/102707" "https://avatars.githubusercontent.com/u/6460407")
answer_inline_multi "${iQUERY[ID]}" "
$(for photo in ${avatar[*]} ; do
echo "${sep}"; inline_query_compose "$RANDOM" "photo" "${photo}" "${photo}"; sep=","
done)
"
;;
2020-08-01 07:10:14 +00:00
"sticker") # example cached telegram sticker
2019-05-09 21:34:45 +00:00
answer_inline_query "${iQUERY[ID]}" "cached_sticker" "BQADBAAD_QEAAiSFLwABWSYyiuj-g4AC"
;;
"gif") # example cached gif
2019-05-09 21:34:45 +00:00
answer_inline_query "${iQUERY[ID]}" "cached_gif" "BQADBAADIwYAAmwsDAABlIia56QGP0YC"
;;
esac
}
# debug function called on start, stop of bot, interactive and background processes
# if your bot was started with debug as second argument
2020-07-02 15:13:09 +00:00
# $1 current date, $2 from where the function was called, $3 ... $n optional information
my_debug_checks() {
2020-07-02 15:13:09 +00:00
# example check because my bot created a wrong file
[ -f ".jssh" ] && printf "%s: %s\n" "${1}" "Ups, found file \"${PWD:-.}/.jssh\"! =========="
}
2020-08-01 07:10:14 +00:00
# called when bashbot send_xxx command failed because we can not connect to telegram
# return 0 to retry, return non 0 to give up
bashbotBlockRecover() {
2020-07-12 11:52:03 +00:00
# place your commands to unblock here, e.g. change IP or simply wait
sleep 60 && return 0 # may be temporary
return 1
}
2019-05-02 10:33:10 +00:00
# place your processing functions here
2019-05-09 21:34:45 +00:00
# $1 search parameter
my_image_search(){
2019-05-10 13:58:19 +00:00
local image result sep="" count="1"
result="$(wget --user-agent 'Mozilla/5.0' -qO - "https://images.search.yahoo.com/search/images?p=$1" | sed 's/</\n</g' | grep "<img src=")"
2019-05-09 21:34:45 +00:00
while read -r image; do
[ "$count" -gt "20" ] && break
2019-05-10 13:58:19 +00:00
image="${image#* src=\'}"; image="${image%%&pid=*}"
[[ "${image}" = *"src="* ]] && continue
2019-05-10 12:56:53 +00:00
echo "${sep}"; inline_query_compose "$RANDOM" "photo" "${image}"; sep=","
2019-05-10 13:58:19 +00:00
count=$(( count + 1 ))
2019-05-09 21:34:45 +00:00
done <<<"${result}"
}
2019-05-02 10:33:10 +00:00
fi