Dzmitry Makarski

<p><strong>Makarski Bot Connector for Telegram</strong> 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.</p>
<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><strong>Webhook & Polling</strong> — works on any hosting; polling mode requires no public HTTPS URL</li>
<li><strong>Command routing</strong> — register bot commands with <code>register_bot_command()</code></li>
<li><strong>Normalized message hook</strong> — <code>tgbot_message</code> fires for all message types (text, photo, voice, video, document, callback_query) with a consistent object structure</li>
<li><strong>Broadcast</strong> — send mass messages to all bot users from the WP admin (Telegram Bot <span aria-hidden="true" class="wp-exclude-emoji">→</span> Broadcast); filter by language, compose per-locale messages, cron-batched delivery with real-time progress and history</li>
<li><strong>Stars payments</strong> — built-in support for Telegram Stars invoices, pre-checkout, and refunds</li>
<li><strong>Multipart uploads</strong> — send photos, audio, voice messages, videos, and documents</li>
<li><strong>Internationalization</strong> — 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>
<p><strong><code>tgbot_message</code></strong> <em>(primary hook)</em><br />
Fires for every non-command incoming message (text, media, callback_query).</p>
<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>
<p><strong><code>tgbot_handle_custom_bot_commands</code></strong><br />
Fires when a slash command is received, before the built-in dispatcher.</p>
<pre><code>add_action( 'tgbot_handle_custom_bot_commands', function( $bot, $user_id, $command ) {
    // $command — e.g. '/mycommand'
}, 10, 3 );
</code></pre>
<p><strong><code>tgbot_bot_call</code></strong><br />
Fires for every incoming update, including commands. Useful for cross-cutting concerns.</p>
<p><strong><code>tgbot_pre_checkout_query</code></strong><br />
Fires when a Telegram Stars pre-checkout query arrives.</p>
<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>
<p><strong><code>tgbot_successful_payment</code></strong><br />
Fires after a successful Telegram Stars payment.</p>
<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>
<p><strong><code>tgbot_raw_message</code></strong><br />
Fires with the raw Telegram update object for advanced use cases.</p>
<h4>Registering bot commands</h4>
<p>Use <code>TGBot\register_bot_command()</code> inside an <code>init</code> hook:</p>
<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>
<p>This plugin communicates with the <strong>Telegram Bot API</strong> (api.telegram.org) to operate a Telegram bot connected to your WordPress site.</p>
<p><strong>What the service is:</strong> Telegram Bot API is a third-party service by Telegram FZ-LLC that allows applications to send and receive messages through Telegram bots.</p>
<p><strong>What data is sent and when:</strong><br />
* Bot token — sent with every API request to authenticate the bot.<br />
* Chat ID — sent when delivering messages to a specific user.<br />
* Message text and media files — sent when the bot responds to users.<br />
* 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).</p>
<p>No data is sent to Telegram unless the bot is enabled and a valid token is configured.</p>
<p><strong>Telegram Privacy Policy:</strong> https://telegram.org/privacy<br />
<strong>Telegram Terms of Service:</strong> https://telegram.org/tos</p>


Makarski Bot Connector for Telegram

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

NickDuncan

<p>HeySpark adds a modern chat, call, and video widget to your site and a conversational inbox inside WP-Admin. Your chat data stays on your WordPress install. No external services, no monthly subscriptions, no accounts to create. Just install, activate, and start chatting.</p>
<h4>Why HeySpark</h4>
<ul>
<li><strong>Self-hosted.</strong> Conversations live in your database, on your server. Nobody else sees them.</li>
<li><strong>No accounts.</strong> Install and go. No signup, no API keys.</li>
<li><strong>Modern UX.</strong> A messenger-style widget your visitors already know how to use.</li>
<li><strong>Fast.</strong> Lightweight, deferred asset loading, no heavy framework dependencies.</li>
<li><strong>Translation-ready.</strong> Full text domain, bundled POT, right-to-left compatible.</li>
</ul>
<h4>Free features</h4>
<ul>
<li>100% free live chat</li>
<li>“Call now” functionality with WebRTC audio calls that are secure and private</li>
<li>Floating chat widget on your site with Shadow DOM isolation (no theme conflicts)</li>
<li>WP-Admin inbox with a conversation view</li>
<li>Real-time chat via long-polling (no external service required)</li>
<li>Online/Away toggle</li>
<li>Offline message form with email notifications when you’re away</li>
<li>Pre-chat form with name + email capture</li>
<li>Optional GDPR consent checkbox with configurable text</li>
<li>Appearance settings: greeting, brand color, launcher position (left/right)</li>
<li>Mobile show/hide toggle</li>
<li>Sound + desktop notifications for new messages</li>
<li>Repeating new-chat sound until you open the conversation</li>
<li>Read receipts (sent / seen ticks), with the exact “seen” time on hover</li>
<li>Auto-close inactive conversations after a chosen time</li>
<li>Live “visitors online” dashboard with activity scores</li>
<li>Optional visitor country lookup in the dashboard, with a country filter (off by default)</li>
<li>Clickable links in the GDPR consent text</li>
<li>Visitor can view previous conversations after a chat is closed</li>
<li>Close conversations from the admin inbox</li>
<li>Translation-ready, bundled POT</li>
<li>Responsive, accessibility-minded design (keyboard navigation, ARIA live regions, focus management)</li>
</ul>
<h4>Pro features (available separately)</h4>
<p>Upgrade to HeySpark Pro for:</p>
<ul>
<li>One-to-one video calls (camera to camera, relayed through your own TURN server)</li>
<li>Agent-initiated chats: proactively message online visitors</li>
<li>Multiple agents: map WP roles to agent capability, route new conversations</li>
<li>Quick responses (canned replies)</li>
<li>Page include/exclude rules</li>
<li>Business hours with timezone support</li>
<li>CSAT ratings after conversations end</li>
<li>Custom branding: your own widget logo and closed chat-bubble icon</li>
<li>“New visitor” alerts (sound and/or desktop notification when someone lands)</li>
<li>“What’s new” announcements shown inside the widget</li>
<li>Custom CSS for the widget</li>
</ul>
<p>Learn more at <a href="https://codecabin.io/store/heyspark-pro" rel="nofollow ugc">codecabin.io/store/heyspark-pro</a>.</p>


HeySpark – Live Chat and Call Now Plugin

Self-hosted live chat plugin for WordPress. Talk to visitors or let them call straight from your admin area, conversations stored on your own site.

Makarski Bot Connector for Telegram vs HeySpark – Live Chat and Call Now Plugin