Skip to content

TuriBot is a simple way to communicate with Telegram APIs in PHP

License

Notifications You must be signed in to change notification settings

kingdavid6336/TuriBot

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TuriBot

TuriBot is a simple way to communicate with Telegram APIs in PHP

Latest Stable Version Total Downloads License

Requirements

Stable

PHP 8.0 or higher with curl extension

Beta (Async)

PHP 8.1 or higher, you need to install amp from composer

Installation

Stable

composer require davtur19/turibot 1.x

Beta (Async)

composer init --name=your.name/yourbot --no-interaction
composer config minimum-stability dev
composer require davtur19/turibot 2.x

Webhook

Setup recommended: open setupWebhook.php in your browser and follow the setup wizard.

Manual setup: set webhook to the file webhook.php, and as parameter GET "api" set your token.

Example for manual setup:

curl https://api.telegram.org/botTOKEN/setWebhook?url=https://WEBSITE/DIR/webhook.php?api=TOKEN

Alternatively if you don't want to use GET, just change this piece of code.

GetUpdates

Setup Token

Usage

  • Look at the examples (webhook.php and getUpdates.php), it's very simple if you know PHP and OOP
  • All methods have the parameters in the same order as the BotAPIs
  • The reply_markup, permissions, commands, entities and parameters that require arrays, already have a json_encode in the functions, you just need to pass arrays

Security

https://github.com/php-telegram-bot/core/wiki/Securing-&-Hardening-your-Telegram-Bot

Custom endpoint

With the Bot API 5.0 it is now possible to self host your own Bot API, here is an example of how to add your own endpoint

//token, json_payload, endpoint
$client = new Client("1234:AAbbccdd", false, "http://endpoint/bot");

Json payload

Only works with webhooks, for more info: https://core.telegram.org/bots/faq#how-can-i-make-requests-in-response-to-updates

I do not recommend using it as it may need a particular configuration to the webserver for flushing and you cannot get a response from the Bot API

Generator

https://github.com/davtur19/TuriBotGen

Contributors

Old version

I don't recommend its use, but it could be useful for those unfamiliar with OOP and would like to start learning how PHP and Telegram Bot Api work.

https://github.com/davtur19/TuriBot/tree/old

About

TuriBot is a simple way to communicate with Telegram APIs in PHP

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%