Plugin tutorial · about 15 minutes

Getting Started with the Telegram Bot Integration Plugin

Set up Telegram Bot Integration & Rewrite Article using ChatGPT (version 2.0) and publish your first WordPress post from Telegram.

Before you start

  • ✓WordPress 6.0 or later (tested up to 7.1) and PHP 7.4 or later
  • ✓A site that is reachable from the internet over HTTPS — Telegram cannot reach localhost or password-protected staging sites
  • ✓The free companion plugin Simple Post Publish & Rewrite using API, version 2.0 or later
  • ✓An OpenAI API key, or on WordPress 7.0+ an AI provider connected in Settings → Connectors (for AI titles and rewriting)
  • ✓A Telegram account and your licence key (it's on your purchase page and in your purchase email)

1Install the free API Publisher plugin

The Telegram bot creates posts through the free Simple Post Publish & Rewrite using API plugin, which also holds your AI settings.

  1. In WordPress go to Plugins → Add New, search for “Simple Post Publish & Rewrite using API”, then install and activate it.
  2. Open API Publisher → Settings. Under AI provider, either paste your OpenAI API key and choose a model (GPT-6 Luna is fast and low-cost), or on WordPress 7.0+ choose “WordPress AI (Settings → Connectors)”.
  3. Click Test connection to check the key, adjust the title and rewrite prompts if you like, and save.
  4. Optional: set the default post status and a fallback category under Publishing defaults.

2Install the Telegram Bot plugin

Download the plugin zip from your purchase page (or the licence link in your email).

  1. Go to Plugins → Add New → Upload Plugin, choose the zip file and click Install Now.
  2. Click Activate. A new Telegram Bot menu appears in the WordPress sidebar.

3Activate your licence

The licence unlocks the bot settings and automatic updates.

  1. Open Telegram Bot → Settings.
  2. Paste your licence key (it looks like TAL-XXXXX-XXXXX-XXXXX-XXXXX) and click Activate.
  3. The licence card now shows when your updates & support end and how many sites you've used.

Tip: Development and staging sites (localhost, *.local, *.test, staging.*, dev.*) don't count towards your site limit. To move a licence, click Deactivate on the old site first.

4Create your bot with @BotFather

Every site uses its own Telegram bot. Creating one takes about a minute.

  1. In Telegram, open @BotFather (look for the blue verified tick) and press Start.
  2. Send /newbot. Enter a display name (e.g. “Tech News Publisher”), then a username that ends in “bot” (e.g. technews_publisher_bot).
  3. BotFather replies with an API token like 123456789:AAH… — copy it and keep it private.
  4. Optional: send /setuserpic and /setdescription to BotFather to give the bot a picture and description.

5Add the bot token to WordPress

Now link the bot to your site.

  1. In Telegram Bot → Settings, paste the token into Bot token and click Test token — you should see your bot's name.
  2. Click Save settings. The plugin registers its webhook with Telegram automatically.
  3. Check the Webhook status: a green dot and “Registered and working” means Telegram can reach your site. If not, click Register webhook.

Tip: The webhook is protected by a secret token, so only Telegram can send messages to it.

6Connect your Telegram account

Each writer links their own Telegram account to their WordPress user — no passwords are ever typed into Telegram.

  1. Click Connect Telegram (in the settings sidebar, or under Users → Profile → Telegram Bot).
  2. Click Open Telegram, then press Start in the chat that opens.
  3. The bot replies “Connected as …” and shows its menu. The link works once and expires after 15 minutes.

7Publish your first post

Send the bot some text — a press release, notes or a full article — and it becomes a draft.

  1. Send more messages to add to the text, or send a photo (with or without a caption) to use as the featured image.
  2. Use the buttons under the draft: AI title (ChatGPT writes the headline), AI rewrite (turns your text into a full, well-structured article), Categories, Tags, Image and Status (draft, pending review or publish).
  3. Tap Publish (or Save draft / Submit for review). AI rewriting usually takes 10–30 seconds.
  4. The bot replies with the headline and buttons to view the post or edit it in WordPress.

Bot commands

/newStart a new post
/postsShow your recent posts and their status
/cancelDiscard the current draft
/helpHow to use the bot
/disconnectDisconnect this chat from WordPress

Adding writers: any Author, Editor or Administrator can use the bot. Ask them to open Users → Profile in WordPress and click Connect Telegram. Posts are created under their own account and permissions, and you can see everyone who is connected in Telegram Bot → Connected users.

Troubleshooting

The bot doesn't reply+

Open Telegram Bot → Settings and check the webhook status. Your site must be public and on HTTPS. If a security plugin, firewall or Cloudflare rule blocks requests to /?ttw_bot_webhook=1, allow that URL, then click Register webhook.

“Telegram only delivers messages to sites on HTTPS” (testing on localhost)+

Telegram can't reach localhost or plain-HTTP sites, so the bot is best tested on your live site. For local development, run a free HTTPS tunnel such as Cloudflare Tunnel (cloudflared tunnel --url http://localhost) and add define( 'TTWB_WEBHOOK_URL', 'https://YOUR-TUNNEL.trycloudflare.com/YOUR-WP-PATH/?ttw_bot_webhook=1' ); to wp-config.php, then click Register webhook. Remove the line when you're done.

“This connect link has expired”+

Connect links work once and last 15 minutes. Click Connect Telegram again to get a new one.

“Your WordPress account is not allowed to publish posts”+

Only users with the Author role or higher can use the bot. Change the user's role in Users → All Users.

The post could not be created / AI error+

Check your AI settings in API Publisher → Settings (Test connection). If the article is cut off, raise Max tokens. Your draft is kept, so you can try again.

The featured image is missing+

Photos sent to the bot are imported automatically. For image URLs, the link must be public and point to a JPG, PNG, GIF, WebP or AVIF file.

No plugin updates appear+

Updates need an active licence with updates included. The licence card shows your updates end date and a Renew button when it has expired — the bot keeps working either way.

Upgrading from version 1.x? Version 2.0 replaces the old username-and-password login with secure account linking, so each writer needs to click Connect Telegram once after updating.

Need help?

Email us at info@techavenuelabs.com with your licence key and a screenshot of Telegram Bot → Settings, and we'll get you running.