Dzmitry Makarski

Makarski Bot Connector for Telegram provides a clean foundation for building Telegram bots powered by WordPress. It handles all the low-level communication with the Telegram Bot API so you can focus on your bot’s logic.
<h4>What it does</h4>
<ul>
<li>Registers a Telegram bot webhook or runs in polling mode (via WP-Cron)</li>
<li>Automatically creates WordPress users for incoming chat IDs</li>
<li>Dispatches incoming messages and commands through WordPress action hooks</li>
<li>Provides a full-featured BotApi class with 30+ methods</li>
</ul>
<h4>Key features</h4>
<ul>
<li>Webhook & Polling — works on any hosting; polling mode requires no public HTTPS URL</li>
<li>Command routing — register bot commands with <code>register_bot_command()</code></li>
<li>Normalized message hook — <code>tgbot_message</code> fires for all message types (text, photo, voice, video, document, callback_query) with a consistent object structure</li>
<li>Broadcast — send mass messages to all bot users from the WP admin (Telegram Bot → Broadcast); filter by language, compose per-locale messages, cron-batched delivery with real-time progress and history</li>
<li>Stars payments — built-in support for Telegram Stars invoices, pre-checkout, and refunds</li>
<li>Multipart uploads — send photos, audio, voice messages, videos, and documents</li>
<li>Internationalization — translatable, ships with a .pot file</li>
</ul>
<h4>Available BotApi methods</h4>
<pre><code>send_message, `send_plain_message`, `send_markdown_message`, `send_photo`, `send_document`, `send_audio`, `send_voice`, `send_video`, `send_animation`, `send_chat_action`, `send_location`, `send_stars_invoice`, `forward_message`, `copy_message`, `delete_message`, `delete_messages`, `edit_message`, `edit_message_markup`, `answer_callback_query`, `answer_pre_checkout_query`, `set_my_commands`, `set_webhook`, `delete_webhook`, `get_webhook_info`, `get_updates`, `get_document_url`, `get_photo_url`, `refund_star_payment`
</code></pre>
<h4>Available action hooks</h4>
<code>tgbot_message</code> (primary hook) 
Fires for every non-command incoming message (text, media, callback_query).
<pre><code>add_action( 'tgbot_message', function( $bot, $user_id, $message ) {
 // $message->type — 'text' | 'image' | 'voice' | 'video' | 'audio'
 // | 'document' | 'sticker' | 'video_note' | 'callback_query'
 // $message->text — message text, caption, or callback data
 // $message->files — array of WP attachment IDs (downloaded files)
 // $message->has_media_group — true if part of a multi-file album
 // $message->media_group_id — Telegram media_group_id string
 if ( $message->type === 'voice' ) {
 $bot->send_message( 'Got a voice message!' );
 }
}, 10, 3 );
</code></pre>
<code>tgbot_handle_custom_bot_commands</code> 
Fires when a slash command is received, before the built-in dispatcher.
<pre><code>add_action( 'tgbot_handle_custom_bot_commands', function( $bot, $user_id, $command ) {
 // $command — e.g. '/mycommand'
}, 10, 3 );
</code></pre>
<code>tgbot_bot_call</code> 
Fires for every incoming update, including commands. Useful for cross-cutting concerns.
<code>tgbot_pre_checkout_query</code> 
Fires when a Telegram Stars pre-checkout query arrives.
<pre><code>add_action( 'tgbot_pre_checkout_query', function( $bot, $query, $user_id ) {
 $bot->answer_pre_checkout_query( $query->id, true );
}, 10, 3 );
</code></pre>
<code>tgbot_successful_payment</code> 
Fires after a successful Telegram Stars payment.
<pre><code>add_action( 'tgbot_successful_payment', function( $bot, $payment, $user_id ) {
 // $payment->telegram_payment_charge_id — use for refunds
 // $payment->total_amount — amount in Stars
}, 10, 3 );
</code></pre>
<code>tgbot_raw_message</code> 
Fires with the raw Telegram update object for advanced use cases.
<h4>Registering bot commands</h4>
Use <code>TGBot\register_bot_command()</code> inside an <code>init</code> hook:
<pre><code>add_action( 'init', function() {
 TGBot\register_bot_command( 'hello', function( $bot ) {
 $bot->send_message( 'Hello, ' . $bot->chat_id . '!' );
 } );

 TGBot\register_bot_command( 'ping', function( $bot ) {
 $bot->send_message( 'Pong 🏓' );
 } );
} );
</code></pre>
<h4>Minimal plugin example</h4>
<pre><code>add_action( 'init', function() {
 TGBot\register_bot_command( 'start', function( $bot ) {
 $bot->send_message( 'Welcome!' );
 } );
} );

add_action( 'tgbot_message', function( $bot, $user_id, $msg ) {
 if ( $msg->type === 'text' ) {
 $bot->send_message( 'You said: ' . esc_html( $msg->text ) );
 }
}, 10, 3 );
</code></pre>
<h3>External Services</h3>
This plugin communicates with the Telegram Bot API (api.telegram.org) to operate a Telegram bot connected to your WordPress site.
What the service is: Telegram Bot API is a third-party service by Telegram FZ-LLC that allows applications to send and receive messages through Telegram bots.
What data is sent and when: 
* Bot token — sent with every API request to authenticate the bot. 
* Chat ID — sent when delivering messages to a specific user. 
* Message text and media files — sent when the bot responds to users. 
* Incoming updates (messages, commands, files) — received from Telegram via webhook (HTTP POST from Telegram to your site) or polling (your site requests updates from Telegram periodically via WP-Cron).
No data is sent to Telegram unless the bot is enabled and a valid token is configured.
Telegram Privacy Policy: https://telegram.org/privacy 
Telegram Terms of Service: https://telegram.org/tos

Makarski Bot Connector for Telegram

Connect WordPress to a Telegram bot. Handle messages, commands, payments and build custom bot logic using WordPress action hooks.

Anna Ladoshkina

Denis Cherniatev

Gleb Suvorov

Описание на русском языке – ниже.
TeploBot – Telegram Bot for WP is the plugin for WordPress that provides basic <a href="https://telegram.org/" rel="nofollow ugc">Telegram</a> chatbot functionality for your site. The bot sends search results from your site as reply to chat users. For developers: the behavior of the bot could be customized.
Plugin features:
<ul>
<li>webhook support to receive automatic updates from Telegram</li>
<li>support for global Telegram commands</li>
<li>send list of serach results into group and privte chats as a response to search requst</li>
<li>support up to 5 custom commands with lists or recent posts or custom post types</li>
<li>in private chats: messages without command processed as search requests </li>
<li>log of messages and responses</li>
<li>posting from Telegram </li>
<li>subscription to notifications about new posts</li>
<li>for developers: commands with custom logic could be defined</li>
<li>for developers: API for sending notifications to subscribers</li>
</ul>
Limitation. In mean time the plugin doesn’t support inline mode. Follow the development progress or send as pull-requests for improvements.
The plugin developed and supported by <a href="https://te-st.ru/" rel="nofollow ugc">Teplitsa. Technologies for Social Good</a>.
Follow the progress at <a href="https://github.com/Teplitsa/TeploBot" rel="nofollow ugc">GitHub</a>
Default commands
<ul>
<li><code>/start</code> Greeting on the dialogue start</li>
<li><code>/help</code> Provide the help text for user</li>
<li><code>/s</code> Provide search results as list of posts’ link</li>
<li><code>/post</code> Submit article to WP site</li>
<li><code>/sub</code> Subscribe to notifications about new posts (or any other content types)</li>
<li><code>/unsub</code> Unsubscribe from notifications about new posts (or any other content types)</li>
</ul>
Admins could add up to 5 custom commands that send list or posts or CPTs to chats. Developers could alter the commands logic through <code>gwptb_supported_commnds_list</code> filter (details published at <a href="https://github.com/Teplitsa/TeploBot" rel="nofollow ugc">GitHub wiki</a>).
Set “Active subscriptions” option to activate subscriptions to notifications.
Commands should be defined in chat with <a href="https://telegram.me/botfather" rel="nofollow ugc">@BotFather</a> to be accepted by plugin: use <code>/setcommands</code> command and follow the instructions.
Help the project
We will be very grateful if you help us to make TeploBot better.
<ul>
<li>Submit a bug report or feature request at <a href="https://github.com/Teplitsa/TeploBot/issues" rel="nofollow ugc">GitHub</a>.</li>
<li>Send us pull-request to share a code improvement.</li>
<li>Translate the plugin into your language</li>
</ul>
РУССКИЙ
TeploBot – Telegram Bot for WP – плагин для WordPress, реализующий простого чатбота для <a href="https://telegram.org/" rel="nofollow ugc">Телеграм</a>. Бот может автоматически отправлять результаты поиска по сайту в ответ на запрос пользователей и позволяет их просматривать. Для разработчиков: состав действий бота может быть расширен.
Основные функции
<ul>
<li>получение и обработка автоматических уведомлений от Телеграм о сообщениях боту</li>
<li>поддержка стандартных команд Телеграм – /start и /help</li>
<li>отправка результатов поиска по сайту в ответ на поисковый запрос (команду)</li>
<li>поддержка до 5 собственных команд, отправляющих список последних записей или пользовательских типов записей</li>
<li>в индивидуальных чатах сообщения, не содержащие команд, трактуются как поисковый запрос </li>
<li>лог сообщений</li>
<li>написание постов из Telegram </li>
<li>подписка на уведомления о новых публикациях</li>
<li>для разработчиков – возможность добавлять собственные команды или менять логику существующих</li>
<li>для разработчиков – API для рассылки уведомлений подписчикам</li>
</ul>
Ограничение. В настоящее время инлайновый режим не поддерживается плагином. Следите за обновлениями и присылайте пулл-реквесты.
Плагин разработан и поддерживается <a href="https://te-st.ru/" rel="nofollow ugc">Теплицей социальных технологий</a>.
Следите за разработкой на <a href="https://github.com/Teplitsa/TeploBot" rel="nofollow ugc">GitHub</a>
Стандартные команды
<ul>
<li><code>/start</code> Начало диалога</li>
<li><code>/help</code> Подсказка и описание команд</li>
<li><code>/s</code> Результаты поиска</li>
<li><code>/post</code> Отправка публикации на сайт</li>
<li><code>/sub</code> Подписка на уведомления о новых публикациях</li>
<li><code>/unsub</code> Отписка от уведомлений о новых публикациях</li>
</ul>
Администраторы сайта могут добавить до 5 собственных команд, отправляющих список последних публикаций в чат. Разработчики могут определять собственные команды или менять логику существующих, используя фильтр <code>gwptb_supported_commnds_list</code> (подробнее в wiki на <a href="https://github.com/Teplitsa/TeploBot" rel="nofollow ugc">GitHub</a>).
Заполните поле “Активные подписки” в настройках, чтобы активировать возможность подписки на уведомления.
Чтобы бот распознавал команды, они должны быть установлены в диалоге с <a href="https://telegram.me/botfather" rel="nofollow ugc">@BotFather</a>: отправьте ему команду <code>/setcommands</code> и следуйте инструкциям.
Помощь проекту
Мы очень ждем вашей помощи проекту. Вы можете помочь следующими способами:
<ul>
<li>Добавить сообщение об ошибке или предложение по улучшению на <a href="https://github.com/Teplitsa/TeploBot/issues/" rel="nofollow ugc">GitHub</a></li>
<li>Поделиться улучшениями кода, послав нам Pull Request</li>
<li>Сделать перевод плагина или оптимизировать его для вашей страны.</li>
</ul>

TeploBot – Telegram Bot for WP

... and the implementation's well too. Wish the project to develop.



The idea is just gorgeous

Плагин простой, понятный. Можно использовать его возможности при разработке прямо в своем коде!



Здорово, что можно соединить сайт с Telegram

Плагин классный! дает понять по коду что надо делать разработчику, 5 баллов!

Спасибо за плагин

TeploBot simple Telegram chatbot with green effect.

Makarski Bot Connector for Telegram vs TeploBot – Telegram Bot for WP