diecoding / yii2-telegram-bot
Yii2 Telegram Bot Api Component
Installs: 13
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Type:yii2-component
Requires
- php: >=7.2
- longman/telegram-bot: ^0.75.0
- yiisoft/yii2: ~2.0.14
Requires (Dev)
- phpunit/phpunit: <7
This package is auto-updated.
Last update: 2024-10-23 12:00:45 UTC
README
Yii2 Telegram Bot
Yii2 Telegram Bot Api Component
Create your first bot
-
Message @botfather https://telegram.me/botfather with the following text:
/newbot
If you don't know how to message by username, click the search field on your Telegram app and type@botfather
, where you should be able to initiate a conversation. Be careful not to send it to the wrong contact, because some users has similar usernames tobotfather
. -
@botfather replies with
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
. -
Type whatever name you want for your bot.
-
@botfather replies with
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
. -
Type whatever username you want for your bot, minimum 5 characters, and must end with bot. For example:
diecoding_yii2_bot
. -
@botfather replies with:
Done! Congratulations on your new bot. You will find it at t.me/diecoding_yii2_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this. Use this token to access the HTTP API: 5162536695:AAGdvgUMbNmTlL8sNW-SZHs32iHnTblPqEM Keep your token secure and store it safely, it can be used by anyone to control your bot. For a description of the Bot API, see this page: https://core.telegram.org/bots/api
-
Note down the 'token' mentioned above.
-
Type
/setprivacy
to @botfather. -
@botfather replies with
Choose a bot to change group messages settings.
. -
Type (or select) @PostMan_bot (change to the username you set at step 5 above, but start it with @)
-
@botfather replies with.
'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username. 'Disable' - your bot will receive all messages that people send to groups. Current status is: ENABLED
-
Type (or select)
Disable
to let your bot receive all messages sent to a group. This step is up to you actually. -
@botfather replies with
Success! The new status is: DISABLED. /help
Installation
The preferred way to install this extension is through composer.
Either run
composer require diecoding/yii2-telegram-bot "@dev"
or add
"diecoding/yii2-telegram-bot": "@dev"
to the require section of your composer.json
file.
Method list usable
list methods
getMe
sendMessage
forwardMessage
sendPhoto
sendAudio
sendDocument
sendSticker
sendVideo
sendLocation
sendChatAction
getUserProfilePhotos
getUpdates
setWebhook
getChat
getChatAdministrators
getChatMembersCount
getChatMember
answerCallbackQuery
editMessageText
editMessageCaption
sendGame
Game
Animation
CallbackGame
getGameHighScores
GameHighScore
answerInlineQuery
setChatStickerSet
deleteChatStickerSet
leaveChat
pinChatMessage
unpinChatMessage
setChatDescription
setChatTitle
deleteChatPhoto
exportChatInviteLink
promoteChatMember
restrictChatMember
unbanChatMember
kickChatMember
editMessageLiveLocation
stopMessageLiveLocation
Migration Table
php yii migrate --migrationPath=@vendor/diecoding/yii2-telegram-bot/src/migrations
Usage
first add to config.php
<?php 'components' => [ 'telegram' => [ 'class' => 'diecoding\telegram\Telegram', 'botToken' => '5162536695:AAGdvgUMbNmTlL8sNW-SZHs32iHnTblPqEM', 'botUsername' => 'diecoding_yii2_bot', ] ] ?>
Once the extension is installed, simply use it in your code by :
<?php Yii::$app->telegram->sendMessage([ 'chat_id' => $chat_id, 'text' => 'test', ]); ?>
send message width inline keyboard by:
<?php Yii::$app->telegram->sendMessage([ 'chat_id' => $chat_id, 'text' => 'this is test', 'reply_markup' => json_encode([ 'inline_keyboard'=>[ [ [ 'text' => 'refresh', 'callback_data' => time(), ] ] ] ]), ]); ?>
send photo by :
<?php Yii::$app->telegram->sendPhoto([ 'chat_id' => $chat_id, 'photo' => Yii::$app->getBaseUrl() . '/uploads/test.jpg', 'caption' => 'this is test' ]); ?>
Usage in controller
First of all you need to disable the enableCsrfValidation feature in the controller
The robot is currently running from your server But when we start /start run the robot from the telegram application on the mobile, the request does not reach the action inside the controller because the telegram sends the request to the POST and yii requests it without csrf Sends Bad Request (# 400). So then the code doesn't run inside your method
Consider the following example
class SiteController extends Controller { public $enableCsrfValidation = false; public function actionIndex() { $res = Yii::$app->telegram->sendMessage([ 'chat_id' => $chat_id, 'text' => 'hello world!!' ]); } }
Sample Code:
How to get user chat_id from the bot ?
You can use :
$telegram->input->message->chat->id
to get chat_id
Sample widget class :
$res = Yii::$app->telegram->sendMessage([ 'chat_id' => $telegram->input->message->chat->id, 'text' => "salam" ]);
New feature Command
How to use the command
use diecoding\telegram\base\Command; Command::run("/start", function($telegram){ $result = $telegram->sendMessage([ 'chat_id' => $telegram->input->message->chat->id, "text" => "hello" ]); });