Laravel >= 5.5+ or Lumen Installation (Optional only if you want to use it with either of these frameworks).
2.0" } } After installing, you need to require Composer's autoloader if you want to use the library standalone:
require 'vendor/autoload.php';
You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at getcomposer.org.
If you're using this SDK with Laravel, the SDK will self-register its ServiceProvider and Facade using Laravel's auto-discovery.
Open your terminal window and fire the following command to publish config file to your config directory:
php artisan vendor:publish --provider="Telegram\Bot\Laravel\TelegramServiceProvider"
👍
Submit Your Bot!
If you're using this SDK to build your Telegram Bots, We'd love to know and share the bot with the world. Tell us about it - here
Check out the Who's Using Telegram Bot SDK wiki page to know more about what people have been building with this SDK.
Thank you for considering contributing to the project. Please review the CONTRIBUTING guidelines before submitting any pull requests.
- Syed Irfaq R.
- All Contributors
Thanks to JetBrains for providing an open-source license to their PhpStorm IDE that has been very useful in developing this SDK. Please go check them out!
This project and its author is neither associated nor affiliated with Telegram in any way.
See License section for more details.
This project is released under the BSD 3-Clause License.
📘
Additional Information
The library takes advantage of the amazing Laravel Collection API to automatically map the data.
So it's a lot easier to work with the array of data. Supports all the methods listed on the official docs.
Any issues, feedback, suggestions or questions please use issue tracker here.
Updated almost 3 years ago
basic concepts for working with API / Sudo Null IT News
Hello everyone, this is the first lesson from the course on developing bots for Telegram.
In this course, we will discuss how to create bots for Telegram in PHP. I will tell you how to send text messages, how to send files, how to receive and process messages from users, and as a result, we will write a script to quickly create a Telegram bot in PHP.
In the first lesson, we will look at the basic concepts associated with the API. I will tell you what API methods and hooks are, use Telegram as an example to build a URL for creating requests, and talk about how simple API requests are created in PHP. nine0003
A complete list of all course records is on site or in publications on Habr .
To send and receive requests via the API, you'd better use shared hosting, as local hosting won't be able to receive data via hooks.
Basic concepts
Let's look at the basic concepts for working with the API.
API (Application Programming Interface) is a set of methods and rules by which various programs communicate with each other and exchange data.
nine0003
API method is a specific action that the application should perform based on the received data (send a message, return a list of chats, send a picture, etc.)
Token (token) is a unique bot key required to send requests.
How to send HTTP requests to PHP
To send HTTP requests, you can use the file_get_contents() function, where the link is specified as the first main parameter. This function is great for sending GET requests, but unfortunately using function file_get_contents() POST requests cannot be sent, so we will use the Curl library to send POST requests.
Curl is a library designed to receive and transmit data via protocols such as HTTP, FTP, HTTPS.
You can read more about Curl on my website .
Types of interaction with the application through the API
There are 2 types of interaction with the application through the API.
The first is from from the client to the server , and the second from the server to the client . In this case, the client is your application (website), and the server is the site to which you send requests (in our case, this is Telegram).
API request is a way to communicate with the program by sending data from client - to server .
Hooks (Hooks) is a way to communicate with the program, by means of sending data from server - client . That is, with certain changes in the program, the server (application) will send data to the specified client script.
Documentation for working with the Telegram API
You can find all methods and parameters for requests in the official Telegram documentation.
Telegram Bot API - https://core.tlgr.org/bots/api
We will refer to this site throughout the course.
Working with documentation for Telegram
Documentation for creating Telegram bots is divided into several sections.
In section Recent changes you can find information about Telegram updates. It describes the versions and innovations that have been made to the functionality of the messenger.
Sections Authorizing your bot and Making requests describe how to authorize bots and how to create requests to work with bots.
Section Getting updates describes how to get bot interaction updates. When a user interacts with bots, all his actions, according to the standard, are recorded on the Telegram servers, and in order to gain access to them, you need to send a request getUpdates .
By sending a request getUpdates you can get the id of the last user who wrote the bot, find out his nickname, message text and the date of sending. If the bot is added to a community, then you can get the community id.
Section Getting updates also describes the rules for setting up hooks, which allows you to send any changes to the developer's server. But we will talk about this later, now let's continue our acquaintance with the documentation. nine0003
The next section that interests us is called Available types . This section describes all types of data that Telegram returns to us. When your script sends a request, after processing it, Telegram will return a response to you in JSON string format, which describes the special parameters.
For example, if you send a message, Telegram will return an array containing the created message id, user id, message creation date, and much more. You can parse all this data and write it to the database. nine0003
The section we'll have to work with the most is Available methods , methods for interacting with the bot. I advise you to go through all the methods and explore all the possibilities of working with bots.
In a nutshell, here are methods for sending messages, files, images, and more. All methods have clear names and described parameters, which makes it easy to read the documentation, even without knowledge of English.
Well, at the end, we have described methods for working with stickers, games in Telegram, methods for working with payment in Telegram. nine0003
URL structure for sending requests to Telegram
The Telegram API has a simple and understandable URL structure for sending requests.
Here is an example URL for creating requests to the bot:
https://api.telegram.org/bot{token}/{method} {token} is a unique key that is issued when the bot is created;
{method} is the request method by which we will receive or send certain data. Depending on the name of the method, we will perform different actions. nine0003
Examples of URLs for requests
These examples are used only for visualization of building a URL, the token specified in the URL is not tied to any bot!
This is how sending messages using the GET method looks like.
The first part of the URL contains the domain api.telegram.org , then we write the string bot with the token that is given to us when creating the bot, after which we specify the sendMessage method and list the GET parameters.
https://api.telegram.org/bot546445612928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendMessage?chat_id=&text=
Sending files to chat looks similar, only method sendMessage is replaced with sendDocument . And GET parameters are not listed here, after specifying the method, since we send data using the POST method.
https://api.telegram.org/bot543264456928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendDocument
Send images to chat:
https://api.telegram.org/bot546413456928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendPhoto
This concludes our acquaintance with the Telegram documentation. In the next lesson, we will create the first bot and try to send simple requests.
The second lesson is already on Habré - https://habr.com/ru/post/697000/
Telegram Documentation: Examples of bots
Advice Read more about bots in introductory article .
Many Telegram users create their own tools for creating bots. On this page, we collect them to make it easier for novice bot builders to find the right library. nine0003
Node.js
Telegraph
Full support for all Bot API features, including games, inline mode, payments, and more.
- Original code
- Documentation
- Examples
- Support
node-telegram-bot-api
- Original code
- Documentation
- Telegram channel
tgapi
Telebot
Botgram
Microframework for creating bots.
telegram-bot-api
Slimbot
PHP
PHP Telegram API
Full implementation of the Bot API in PHP7.
PHP Telegram Bot
Plugin support library.
nine0184 
https://github.com/skrtdev/NovaGram
https://github.com/NicoNex/echotron
A simple, but extensible Python implementation for the Telegram Bot API. https://github.com/eternnoir/pyTelegramBotAPI
An elegant Telegram bots framework. https://github.com/teloxide/teloxide
com/vendelieu/telegram-bot
https://github.com/mullwar/telebot
Telegram Bot SDK for Swift. https://github.com/rapierorg/telegram-bot-swift
A Java EE Telegram Bot API. https://github.com/rebasing-xyz/rebot
Nadia. Telegram Bot API Wrapper. https://github.com/zhyu/nadia
https://github.com/nv-vn/TelegraML
1 SDK for PHP language.
