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.

Phuc Nguyen

Yivic Easy Live Chat adds floating chat buttons for Zalo and Facebook Messenger to your WordPress site.
This makes it easy for your visitors to contact you through their preferred chat app.
You can enable or disable each chat option, customize phone numbers or IDs, and change display settings directly from 
Settings → Yivic Easy Live Chat.
<h4>Features</h4>
<ul>
<li>Add Zalo chat button</li>
<li>Add Messenger chat button</li>
<li>Optional phone call button</li>
<li>Simple and lightweight</li>
<li>No tracking, no external dependencies</li>
<li>Easy to configure</li>
</ul>

Yivic Easy Live Chat

Yivic Easy Live Chat adds floating chat buttons for Zalo, Messenger and Phone to your WordPress site.

Makarski Bot Connector for Telegram vs Yivic Easy Live Chat