Notification for Telegram

When you create a Telegram bot, BotFather generates a unique token for you. BotFather (@botfather) is the official Telegram bot for creating and managing bots — search for it directly inside Telegram.

Creating a new bot

1. 01Open Telegram and search for @botfather.
2. 02Send the command /newbot.
3. 03BotFather will ask you for two things: Name — the display name shown in contact details and conversations (e.g. “My Awesome Bot”).
4. 04Username — a short unique handle used in mentions and t.me links (e.g. @my_awesome_bot). Usernames must be 5–32 characters long, can only contain Latin letters, numbers and underscores, and must end in “bot”.
5. 05Once created, BotFather will provide your authorization token.

What does a token look like?

A token is a string in this format: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

This token is required to authorize your bot and send requests to the Telegram Bot API. Keep it private — anyone who has it can take full control of your bot.

What if I lose my token or it gets compromised?

Send the /token command to @botfather, select your bot, and it will generate a new token. The old one will be immediately invalidated.

There are two quick ways:

1. 01Search for @userinfobot or @get_id_bot on Telegram, send /start and the bot will instantly reply with your numeric user ID (e.g. 29627823).
2. 02Search for @RawDataBot (https://t.me/RawDataBot), send any message, and it will reply with your full account info including your ID.

Add your bot to the group as a member. Send any message in the group (or type /start@yourbotname). Open the following URL in your browser, replacing with your bot token: https://api.telegram.org/bot/getUpdates Look for the “chat” object in the JSON response — the “id” field is your group Chat ID. Group IDs are always negative numbers (e.g. -1001234567890). Note: if the result is empty, make sure you sent a message after adding the bot, then refresh the URL.

Add your bot to the channel and assign it Administrator privileges. Post any message in the channel. Open the following URL in your browser: https://api.telegram.org/bot/getUpdates Find the “chat” object in the JSON — the “id” is your channel Chat ID. Channel IDs always start with -100 (e.g. -1009876543210).

Yes. Add @RawDataBot (https://t.me/RawDataBot) to your group or channel (as admin), or simply message it privately. Send any message and it will reply with a full JSON breakdown of the chat, including the exact Chat ID you need.

This usually means no messages have been sent to the bot recently. Try the following: 1. Make sure the bot has been added to the chat. 2. Send a new message in the chat (or write directly to the bot in a private conversation). 3. Reload the getUpdates URL in your browser. If the response is still empty, check that no other application is consuming the bot updates (e.g. a webhook that is already set — in that case you need to delete it first via /deleteWebhook).

Yes you can add more than one chattid separated by a comma (,) both in option page and in the shortcode.

Yes! The plugin includes WP-CLI support. Once WP-CLI is installed on your server you can use the wp telegram command.

Send a simple message: wp telegram send “Backup complete”

Send to a specific chat ID (overrides plugin settings): wp telegram send “Hello” –chatid=123456789

Send the output of a shell command: wp telegram send “$(df -h)”

Pipe any command output: df -h | wp telegram send –

Send a message with an inline button: wp telegram send “Deploy done” –urlname=”Open site” –urllink=”https://yoursite.com”

Test the connection: wp telegram test

Show current plugin configuration: wp telegram status

Send a plugin update report to Telegram: wp telegram report_updates

Send a WordPress core update report to Telegram: wp telegram report_core

Show all available commands: wp telegram help

Yes! This is more reliable than WP-Cron. Add these lines to your crontab (crontab -e):

`# Send plugin update report every day at 8am 0 8 * * * cd /var/www/html && wp telegram report_updates –allow-root

0 9 * * * cd /var/www/html && wp telegram report_core –allow-root`

Yes! Starting from version 3.5, this plugin supports the WordPress Abilities API and is compatible with MCP (Model Context Protocol), the open standard that allows AI agents like Claude, ChatGPT, and others to interact with WordPress autonomously.

You need to install two additional free plugins: * Abilities API — github.com/WordPress/abilities-api/releases * MCP Adapter — github.com/WordPress/mcp-adapter/releases

Once both are active, the “Send Telegram Message” ability is automatically available to any authorized AI agent. No extra configuration needed.

Via WordPress Application Passwords — go to Users → Your Profile → Application Passwords, create one, and use it in your MCP client configuration. Your main password is never exposed.

An authorized AI agent can: * Send a Telegram message with custom text * Include an optional inline button with label and URL * Target a specific Telegram chat ID, overriding the default

You can test everything for free using curl from your terminal.

First, make sure the plugin is configured and the built-in “Send Test Message” button works correctly in the plugin settings.

Then run these commands in order:

Step 1 — Initialize the session and get the Session ID:

curl -X POST “https://YOURSITE.com/wp-json/nftb-telegram/mcp” \ -H “Content-Type: application/json” \ -u “ADMIN:APP_PASSWORD” \ -D – \ -d ‘{“jsonrpc”:”2.0″,”id”:1,”method”:”initialize”,”params”:{“protocolVersion”:”2024-11-05″,”capabilities”:{},”clientInfo”:{“name”:”test”,”version”:”1.0″}}}’

Look for the Mcp-Session-Id value in the response headers and copy it.

Step 2 — Verify the tool is available:

curl -X POST “https://YOURSITE.com/wp-json/nftb-telegram/mcp” \ -H “Content-Type: application/json” \ -H “Mcp-Session-Id: YOUR-SESSION-ID” \ -u “ADMIN:APP_PASSWORD” \ -d ‘{“jsonrpc”:”2.0″,”id”:2,”method”:”tools/list”,”params”:{}}’

You should see “notification-for-telegram-send-message” in the response.

Step 3 — Send a real Telegram message via MCP:

curl -X POST “https://YOURSITE.com/wp-json/nftb-telegram/mcp” \ -H “Content-Type: application/json” \ -H “Mcp-Session-Id: YOUR-SESSION-ID” \ -u “ADMIN:APP_PASSWORD” \ -d ‘{“jsonrpc”:”2.0″,”id”:3,”method”:”tools/call”,”params”:{“name”:”notification-for-telegram-send-message”,”arguments”:{“message”:”🤖 MCP is working!”}}}’

If the message arrives in your Telegram chat — everything is working correctly.

APP_PASSWORD = a WordPress Application Password (Users → Your Profile → Application Passwords).

This feature is currently experimental. We welcome feedback and bug reports — if you test it, please leave a review or open an issue on the plugin’s GitHub page.

Once the required plugins are installed, your MCP endpoint will be available at: https://yoursite.com/wp-json/nftb-telegram/mcp

Yes! You can use the [telegram_mess] shortcode to send Telegram messages directly from your pages, posts or PHP code.

Available parameters:

• message — The message to send. Example: message=”hello world”
• chatids — Recipient(s) separated by comma. Example: chatids=”000000,111111″. If omitted, uses the default chat ID from plugin settings.
• token — Your Telegram bot token. Example: token=”123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11″. If omitted, uses the default token from plugin settings.
• showsitename — If set to “1” appends the site name to the message. Default: “0”. Example: showsitename=”1″
• showip — If set to “1” appends the user IP address to the message. Default: “0”. Example: showip=”1″
• showcity — If set to “1” appends the user city name to the message. Default: “0”. Example: showcity=”1″

Basic usage in a page or post: [telegram_mess message=”hello world”]

Full example with all parameters: [telegram_mess message=”hello world” chatids=”000000,111111″ token=”123456:ABC-DEF” showsitename=”1″ showip=”1″ showcity=”1″]

Yes! Use do_shortcode() to call it from your theme or plugin:

<?php $date = date("d-m-Y"); do_shortcode('[telegram_mess message="' . $date . '" chatids="0000000" token="000000000:AAAAAAAAAA" showsitename="1" showip="1" showcity="1"]'); ?>

Yes! The plugin provides 4 filter hooks to customize the WooCommerce order notification message. You can add custom content in 4 positions: Header, Before Items, After Items, and Footer.

<?php add_filter('nftb_order_header_message_hook', 'my_filter_function', 10, 1); add_filter('nftb_order_before_items_hook', 'my_filter_function', 10, 1); add_filter('nftb_order_after_items_hook', 'my_filter_function', 10, 1); add_filter('nftb_order_footer_message_hook', 'my_filter_function', 10, 1); function my_filter_function($order_id) { $order = wc_get_order($order_id); if ($order) { $payment_status = $order->get_status(); $payment_method = $order->get_payment_method(); } return "\r\n\r\n".$payment_method."(".$payment_status.")\r\n"; } ?>

Yes! Use the nftb_order_product_line_hook filter. You can either add content to the existing line or completely replace it.

<?php add_filter('nftb_order_product_line_hook', 'my_item_line_function', 10, 3); function my_item_line_function($message, $product_id, $item) { // ADD content to the original