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.

Facebook

Communicate with customers on your website with Messenger-powered chat. Chat Plugin is a chat widget maintained by the Meta Business that enables live chat on your website.
Whether they’re on their computer or their phone, website visitors will be able to message you anytime by clicking on a small Messenger chat bubble in the lower right corner of your site.
Key features:
<ul>
<li>Website visitors can message you while browsing your site.</li>
<li>Set up auto-replies and answers to common questions to serve customers when you’re not available.</li>
<li>Continue the conversation with customers on Messenger even after they leave your website.</li>
<li>Visitors without a Facebook Messenger account can ask you questions anonymously in Guest mode.</li>
<li><a href="https://www.facebook.com/business/messenger/get-started" rel="nofollow ugc">Messenger</a>’s familiar interface builds trust.</li>
<li>No need to switch between apps to answer questions you get on the website.</li>
</ul>

Facebook Chat Plugin – Live Chat Plugin for WordPress

The Facebook Chat Plugin makes it easy for your website visitors to chat with you and ask you questions, even if they don't have Messenger.

Makarski Bot Connector for Telegram vs Facebook Chat Plugin – Live Chat Plugin for WordPress