2.2 KiB
Examples
Bashtbot webhook examples
webhooks
Bashbot default mode is to poll Telegram server for updates. Telegram offers the more efficient webhook method to deliver updates.
If your server is reachable from the Internet, you can use the webhook method described here (experimental), instead of running bashbot
with bashbot.sh start
Setup webhook
To get updates with webhooks your server must be reachable from the internet and you must inform Telegram about where to deliver updates,
this will be done by calling set_webhook URL. For security reasons bashbot adds you bottoken to the URL.
Example:
bin/any_command.sh set_webhook "https://myserver.com/telegram"
will instruct Telegram to use the URL https://myserver.com/telegram/<your_bot_token>/ to deliver updates.
After you setup webhook to deliver updates it's no more possible to poll updates with bashbot.sh start.
To stop delivering of updates with webhook run bin/any_command.sh delete_webhook
Important: Only https connections with a valid certificate chain are allowed as endpoint for webhook.
Using Apache with php enabled
If you have an Apache webserver with a valid SLL certificate chain and php running you can use it as webhook endpoint:
- setup bashbot to run as the same user as your web server (
bashbot.sh init) - create the directory
telegram/<your_bot_token>in apache web root - copy files all files form here into new directory and change to it
- edit
BASHBOT_HOMEto point to your bashbot installation directory - setup webhook for your server (e.g.
bin/any_command.sh set_webhook "https://myserver.com/telegram) - send a command to your bot (e.g.
/start) to check correct setup
Example minimal index.php, see index.php for complete implementation.
<?php
// bashbot home
$BASHBOT_HOME='/usr/local/telegram-bot-bash';
$cmd=$BASHBOT_HOME.'/bin/process_update.sh';
// save server context and webhook JSON
$json = file_get_contents("php://input");
// process teegram update
chdir($BASHBOT_HOME);
$handle = popen( $cmd, 'w' );
fwrite( $handle, $json.'\n' );
pclose($handle);
?>