Notification for Telegram

Creating a new bot

Open Telegram and search for @botfather.
Send the command /newbot.
BotFather will ask you for two things:

Name — the display name shown in contact details and conversations (e.g. "My Awesome Bot").
Username — 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".

Once created, BotFather will provide your authorization token.

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.

Send the /token command to @botfather, select your bot, and it will generate a new token. The old one will be immediately invalidated.
How do I find my personal Telegram Chat ID?
There are two quick ways:

Search for @userinfobot or @get_id_bot on Telegram, send /start and the bot will instantly reply with your numeric user ID (e.g. 29627823).
Search 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).

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).

Is there a universal method that works for users, groups and channels?
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.
My getUpdates response is empty — what should I do?
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).
Can i insert more than one recipient chatid?
Yes you can add more than one chattid separated by a comma (,)
both in option page and in the shortcode.
Does this plugin support AI agents and MCP?
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.
What do I need to enable MCP support?
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.
How does an AI agent authenticate?
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.
What can an AI agent do with this plugin?
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
How can I test the MCP integration without an AI?
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).
Is MCP support stable?
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.
Where can I find the MCP endpoint?
Once the required plugins are installed, your MCP endpoint will be available at:
https://yoursite.com/wp-json/nftb-telegram/mcp