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.

lepo.co

Messenger custom chat on your website for free. Modify colors, choose languages, integrate with PolyLang, change positions and much more… It’s easy! 
Live Chat (Messenger API) is an easy-to-use plugin that helps ordinary users to start Messenger customer chat on their site.
All you have to do is add the ID of your fanpage, which you can find in the Information tab.

Live Chat (Messenger API) + PolyLang

WOW WOW WOW!

Thank you for this. You just made my life so much easier. I have not fully tested it, but if it works with my langs then the 5 stars remain as 5 stars. BEAUTIFUL!

I rely heavily on PolyLang & Elementor and I am part of our own PolyLang plugin for Elementor. So this is really great stuff. 

Please keep dev going!

MultiLingual Support

Facebook Messenger on your website. Modify colors, choose languages, integrate with PolyLang, change positions and much more... It's easy!

Makarski Bot Connector for Telegram vs Live Chat (Messenger API) + PolyLang