Wen-in-Air

web-in-air-shop-connect-for-telegram connects your WooCommerce store to a Telegram bot, allowing your customers to browse products, view details, select variations, and much more, all without leaving their favorite messaging app.
This plugin offers a new, fast, and native shopping experience for millions of Telegram users.
Key Features: 
* Browse products, categories, tags, and brands. 
* Integrated product search. 
* Display product details, price, descriptions, and photo gallery. 
* Full support for variable products. 
* Simple admin panel to configure your bot.
<h3>External Services</h3>
This plugin connects to the official Telegram Bot API (api.telegram.org) to send and receive messages. This connection is essential for the bot to function.
<ul>
<li>Service: Telegram Bot API</li>
<li>Purpose: Allows the WordPress site to interact with the Telegram bot (sending product info, menus, receiving user commands).</li>
<li>Data Sent: Bot token (for authentication), chat ID, message content (text, button data), product information requested by the user. No personal user data beyond the Telegram chat context is sent. Data is sent whenever a user interacts with the bot or when the plugin registers/deletes the webhook.</li>
<li>Links: <a href="https://telegram.org/privacy" rel="nofollow ugc">Telegram Privacy Policy</a>, <a href="https://core.telegram.org/bots/api#terms-of-service" rel="nofollow ugc">Telegram Bot API Terms</a></li>
</ul>

Web-in-Air: Shop Connect for Telegram

Transform your WooCommerce store into an interactive shopping bot on Telegram.

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.

Web-in-Air: Shop Connect for Telegram vs Makarski Bot Connector for Telegram