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. Open Telegram and search for @botfather.
2. Send the command /newbot.
3. BotFather will ask you for two things:
4. Name — the display name shown in contact details and conversations (e.g. "My Awesome Bot").
5. 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".
6. Once created, BotFather will provide your authorization token.

There are two quick ways:

1. 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).
2. Search for @RawDataBot (https://t.me/RawDataBot), send any message, and it will reply with your full account info including your ID.

1. Add your bot to the group as a member.
2. Send any message in the group (or type /start@yourbotname).
3. Open the following URL in your browser, replacing with your bot token: https://api.telegram.org/bot/getUpdates
4. 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).

1. Add your bot to the channel and assign it Administrator privileges.
2. Post any message in the channel.
3. Open the following URL in your browser: https://api.telegram.org/bot/getUpdates
4. 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! 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