Via Composer
composer require tg-bot-api/bot-api-baseWe support all psr17 and psr18 implementations, but we will use guzzle6 for example
composer require php-http/guzzle6-adapter http-interop/http-factory-guzzle$botKey = '<bot key>';
$requestFactory = new Http\Factory\Guzzle\RequestFactory();
$streamFactory = new Http\Factory\Guzzle\StreamFactory();
$client = new Http\Adapter\Guzzle6\Client();
$apiClient = new \TgBotApi\BotApiBase\ApiClient($requestFactory, $streamFactory, $client);
$bot = new \TgBotApi\BotApiBase\BotApi($botKey, $apiClient, new \TgBotApi\BotApiBase\BotApiNormalizer());
$userId = '<user id>';
$bot->send(\TgBotApi\BotApiBase\Method\SendMessageMethod::create($userId, 'Hi'));You can configure it to work in symfony, for example, in this way.
| Method | Allowed type | response |
|---|---|---|
| add | AddStickerToSetMethod | bool |
| answer | AnswerCallbackQueryMethod, AnswerInlineQueryMethod, AnswerPreCheckoutQueryMethod, AnswerShippingQueryMethod | bool |
| create | CreateNewStickerSetMethod | bool |
| delete | DeleteChatPhotoMethod, DeleteChatStickerSetMethod, DeleteMessageMethod, DeleteStickerFromSetMethod, DeleteWebhookMethod | bool |
| edit | EditMessageCaptionMethod, EditMessageLiveLocationMethod, EditMessageMediaMethod, EditMessageReplyMarkupMethod, EditMessageTextMethod | bool |
| forward | ForwardMessageMethod | MessageType |
| kick | KickChatMemberMethod | bool |
| leave | LeaveChatMethod | bool |
| pin | PinChatMessageMethod | bool |
| promote | PromoteChatMemberMethod | bool |
| restrict | RestrictChatMemberMethod | bool |
| send | SendPhotoMethod, SendAudioMethod, SendDocumentMethod, SendVideoMethod, SendAnimationMethod, SendVoiceMethod, SendVideoNoteMethod, SendGameMethod, SendInvoiceMethod, SendLocationMethod, SendVenueMethod, SendContactMethod, SendStickerMethod, SendMessageMethod, SendPollMethod, SendDiceMethod | MessageType |
| set | SetChatDescriptionMethod, SetChatPhotoMethod, SetChatStickerSetMethod, SetChatTitleMethod, SetGameScoreMethod, SetStickerPositionInSetMethod, SetWebhookMethod, SetPassportDataErrorsMethod, SetChatPermissionsMethod, SetChatAdministratorCustomTitleMethod, SetMyCommandMethod, SetStickerSetThumbMethod | bool |
| stop | StopMessageLiveLocationMethod | bool |
| stopPoll | StopPollMethod | Poll |
| unban | UnbanChatMemberMethod | bool |
| unpin | UnpinChatMessageMethod | bool |
| upload | UploadStickerFileMethod | FileType |
| exportChatInviteLink | ExportChatInviteLinkMethod | string |
| sendChatAction | SendChatActionMethod | bool |
| getUpdates | GetUpdatesMethod | UpdateType[] |
| getMe | GetMeMethod | UserType |
| getMyCommands | GetMyCommandsMethod | BotCommandType |
| getUserProfilePhotos | GetUserProfilePhotosMethod | UserProfilePhotosType |
| getWebhookInfo | GetWebhookInfoMethod | WebhookInfoType |
| getChatMembersCount | GetChatMembersCountMethod | int |
| getChat | GetChatMethod | ChatType |
| getChatAdministrators | GetChatAdministratorsMethod | ChatMemberType[] |
| getChatMember | GetChatMemberMethod | ChatMemberType |
| getGameHighScores | GetGameHighScoresMethod | GameHighScoreType[] |
| getStickerSet | GetStickerSetMethod | StickerSetType |
| getFile | GetFileMethod | FileType |
| sendMediaGroup | SendMediaGroupMethod | MessageType[] |
| getAbsoluteFilePath | FileType | string |
| call($method, [string $type]) | any method class, [optional expected type] | array or excepted type object |
Implemented all methods and types referenced by official Api
You can use BotApiComplete instance as helper to call
all methods from official Api like this:
$botKey = '<bot key>';
$requestFactory = new Http\Factory\Guzzle\RequestFactory()
$streamFactory = new Http\Factory\Guzzle\StreamFactory();
$client = new Http\Adapter\Guzzle6\Client();
$apiClient = new \TgBotApi\BotApiBase\ApiClient($requestFactory, $streamFactory, $client);
$bot = new \TgBotApi\BotApiBase\BotApiComplete($botKey, $apiClient, new \TgBotApi\BotApiBase\BotApi\BotApiNormalizer());
$userId = '<user id>';
$bot->sendMessage(\TgBotApi\BotApiBase\Method\SendMessageMethod::create($userId, 'Hi'));Method fetch() of WebhookFetcher handling Psr\Http\Message\RequestInterface or string and always returns instance of UpdateType or throwing BadRequestException.
$fetcher = new \TgBotApi\BotApiBase\WebhookFetcher(new \TgBotApi\BotApiBase\BotApiNormalizer());
$update = $fetcher->fetch($request);Please see CHANGELOG for more information on what has changed recently.
$ composer testPlease see CONTRIBUTING and CODE_OF_CONDUCT for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent