8.1 KiB
Home
Advanced Features
Access control
Bashbot offers functions to check what Telegram capabilities like 'chat admin' or 'chat creator' the given user has:
# return true if user is admin/owner of the bot
# -> botadmin is stored in file './botadmin'
user_is_botadmin "user"
# return true if user is creator or admin of a chat
user_is_admin "chat" "user"
# return true if user is creator of a chat or it's a one to one chat
user_is_creator "chat" "user"
# examples:
user_is_botadmin "${USER[ID]}" && send_markdown_message "${CHAT[ID]}" "You are *BOTADMIN*."
user_is_admin "${CHAT[ID]}" "${USER[ID]}" && send_markdown_message "${CHAT[ID]}" "You are *CHATADMIN*."
In addition you can check individual capabilities of users as you must define in the file ./botacl:
# file: botacl
# a user not listed here, will return false from 'user_is_allowed'
#
# Format:
# user:ressource:chat
# allow user 123456789 access to all resources in all chats
123456789:*:*
# allow user 12131415 to start bot in all chats
12131415:start:*
# allow user 987654321 only to start bot in chat 98979695
987654321:start:98979695
# * are only allowed on the right hand side and not for user!
# the following exaples are NOT valid!
*:*:*
*:start:*
*:*:98979695
You must use the function user_is_allowed to check if a user has the capability to do something. Example: Check if user has capability to start bot.
case "$MESSAGE" in
################################################
# GLOBAL commands start here, only edit messages
'/start'*)
user_is_botadmin "${USER[ID]}" && send_markdown_message "${CHAT[ID]}" "You are *BOTADMIN*."
if user_is_allowed "${USER[ID]}" "start" "${CHAT[ID]}" ; then
bot_help "${CHAT[ID]}"
else
send_normal_message "${CHAT[ID]}" "You are not allowed to start Bot."
;;
esac
See also Bashbot User Access Control functions
Interactive Chats
Interactive chats are scripts, reading user input and echo data to the user.
To create a new interactive chat script copy 'scripts/interactive.sh.clean' to e.g. 'scripts/mynewinteractive.sh', make it executeable and then use 'start_proc' function from your bot, it's possible to pass two arguments. You find more examples for interactive scripts in 'examples'
usage: start_proc chat_id script arg1 arg2
Note: From Version 0.96 on scripts must read user input from '$3' instead of stdin!
#!/bin/bash
######
# parameters
# $1 $2 args as given to start_proc chat srcipt arg1 arg2
# $3 path to named pipe
#######################
# place your commands here
#
INPUT="${3:-/dev/stdin}" # read from stdin if run in terminal
echo "Enter a message:"
read -r test <"${INPUT}"
echo -e "Your Message: ${test}\nbye!"
message formatting and keyboards
The output of the script will be processed by 'send_messages', so you can not only send text, but also keyboards, files, locations and more. Each newline in the output will start an new message to the user, to insert line breaks in your message you must insert ' mynewlinestartshere ' instead of a newline..
To open up a keyboard in an interactive script, print out the keyboard layout in the following way:
echo "Text that will appear in chat? mykeyboardstartshere [ \"Yep, sure\" , \"No, highly unlikely\" ]"
Same goes for files:
echo "Text that will appear in chat? myfilelocationstartshere /home/user/doge.jpg"
And buttons:
echo "Text that will appear in chat. mybtextstartshere Klick me myburlstartshere https://dealz.rrr.de"
And locations:
echo "Text that will appear in chat. mylatstartshere 45 mylongstartshere 45"
And venues:
echo "Text that will appear in chat. mylatstartshere 45 mylongstartshere 45 mytitlestartshere my home myaddressstartshere Diagon Alley N. 37"
You can combine them:
echo "Text that will appear in chat? mykeyboardstartshere [ \"Yep, sure\" , \"No, highly unlikely\" ] myfilelocationstartshere /home/user/doge.jpg mylatstartshere 45 mylongstartshere 45"
Please note that you can either send a location or a venue, not both. To send a venue add the mytitlestartshere and the myaddressstartshere keywords.
New in v0.6: To insert a linebreak in your message you can insert mynewlinestartshere in your echo command:
echo "Text that will appear in one message mynewlinestartshere with this text on a new line"
New in v0.7: In case you must extend a message already containing a location, a file, a keyboard etc.,
with additionial text simply add mytextstartshere additional text at the end of the string:
out="Text that will appear mylatstartshere 45 mylongstartshere 45"
[[ "$out" != *'in chat'* ]] && out="$out mytextstartshere in chat."
echo "$out"
Background Jobs
A background job is similar to an interactive chat, but runs in the background and does only output massages and does not get user input. In contrast to interactive chats it's possible to run multiple background jobs. To create a background job write a script or edit 'examples/notify.sh' script and use the funtion background to start it:
background "examples/notify.sh" "jobname"
All output of the script will be sent to the user, to stop a background job use:
killback "jobname"
You can also suspend and resume the last running background jobs from outside bashbot, e.g. in your startup schripts:
./bashbot.sh suspendback
./bashbot.sh resumeback
If you want to kill all background jobs permantly run:
./bashbot.sh killback
Note: Background Jobs run independent from main bot and continue running until your script exits or you stop if from your Bot. Backgound Jobs will continue running if your Bot is stopeda and must be terminated, e.g. by bashbot.sh killback
Inline queries
Inline queries allow users to send commands to your bot from every chat without going to a private chat. An inline query is started if the user type the bots name, e.g. @myBot. Everything after @myBot is immediatly send to the bot.
In order to enable inline mode, send /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot’s name.
The following commands allows you to send ansers to inline queries. To enable bashbot to process inline queries set INLINE="1" in 'mycommands.sh'.
To send messsages or links through an inline query:
answer_inline_query "${iQUERY[ID]}" "article" "Title of the result" "Content of the message to be sent"
To send photos in jpeg format and less than 5MB, from a website through an inline query:
answer_inline_query "${iQUERY[ID]}" "photo" "A valid URL of the photo" "URL of the thumbnail"
To send standard gifs from a website (less than 1MB) through an inline query:
answer_inline_query "${iQUERY[ID]}" "gif" "gif url"
To send mpeg4 gifs from a website (less than 1MB) through an inline query:
answer_inline_query "${iQUERY[ID]}" "mpeg4_gif" "mpeg4 gif url"
To send videos from a website through an inline query:
answer_inline_query "${iQUERY[ID]}" "video" "valid video url" "Select one mime type: text/html or video/mp4" "URL of the thumbnail" "Title for the result"
To send photos stored in Telegram servers through an inline query:
answer_inline_query "${iQUERY[ID]}" "cached_photo" "identifier for the photo"
To send gifs stored in Telegram servers through an inline query:
answer_inline_query "${iQUERY[ID]}" "cached_gif" "identifier for the gif"
To send mpeg4 gifs stored in Telegram servers through an inline query:
answer_inline_query "${iQUERY[ID]}" "cached_mpeg4_gif" "identifier for the gif"
To send stickers through an inline query:
answer_inline_query "${iQUERY[ID]}" "cached_sticker" "identifier for the sticker"
See also answer_inline_multi, answer_inline_compose and mycommands.sh for more information.