Skip to Content
ChannelsTelegram

Telegram

Connect Telegram and every post you publish goes out as a message to the Telegram chat, channel, or group of your choice. Great for broadcasting to a Telegram channel of subscribers, or just pinging yourself.

Telegram requires a small bit of one-time setup in the Telegram app itself — creating a bot and finding the chat ID — but once that’s done, the Structura side is quick.

What gets posted

A single Telegram message per publish:

  • Post title in bold.
  • Short summary from the excerpt or first paragraph.
  • Link to the article on your WordPress site.
  • Featured image as the message’s photo attachment (when available).

What you need

Two pieces of information:

  • A bot token from Telegram’s BotFather.
  • A chat ID — the numeric identifier of the chat, channel, or group you want the bot to post to.

Both come from the Telegram app itself; steps below.

Create a Telegram bot

Do this once, in Telegram:

  1. Open Telegram and search for @BotFather. Start a chat.
  2. Send /newbot.
  3. Give the bot a display name (e.g., “Structura Publisher”).
  4. Give it a username ending in bot (e.g., mysite_structura_bot).
  5. BotFather replies with a bot token — a long string like 123456:ABCdef.... Copy it. This is a secret.

Get your chat ID

The chat ID tells the bot where to post. The quickest way to find it is a helper bot like @RawDataBot or @getidsbot — no bot token or browser needed for this step.

For a private chat with yourself:

  1. In Telegram, search for @RawDataBot (or @getidsbot) and click Start.
  2. It replies instantly with a block of data. Find the "chat" section and copy its id — a positive integer like 685793393. That number is your chat ID.
  3. Before Structura can message you, you must first open your own bot and click Start — a bot can’t start a conversation with you (see the note under “What can go wrong”).

For a Telegram channel:

  1. Post any message in the channel.
  2. Forward that message to @getidsbot (or @RawDataBot). It replies with the channel’s ID — a negative integer prefixed with -100, e.g., -1001234567890.
  3. Add your Structura bot as an administrator of the channel (Channel settings → Administrators → Add admin) so it can post.

For a Telegram group:

  1. Add @RawDataBot (or @getidsbot) to the group as a member.
  2. It posts a message showing the group’s id — a negative integer. Copy it.
  3. Add your Structura bot to the same group so it can post. You can remove the helper bot afterwards.

Connect

  1. In wp-admin, go to Structura → Channels.
  2. Click the Telegram card. The install panel opens.
  3. Paste the bot token into the Bot token field.
  4. Paste the chat ID into the Chat ID field.
  5. Click Connect. Structura calls Telegram’s getMe and sendMessage to verify the credentials and that the bot can post to the chat. If both succeed, the install panel shows Connected and the target chat receives a “Structura connected” test message.

What can go wrong

  • Unauthorized on connect. The bot token is wrong or the bot was deleted.
  • chat not found. The chat ID is wrong, the bot isn’t a member of that chat/channel, or the bot isn’t an admin of the channel.
  • Forbidden: bot can't initiate conversation with a user. For private chats, the bot can only message you after you’ve messaged it first. Send your bot a message and retry.
  • Message sent but no image. The post’s featured image may be too large (Telegram rejects files over 10 MB for bots) or its URL may not be publicly reachable.

See A channel shows “failed” for the full playbook.

Rotating the token or moving chats

  • New token: regenerate with /token in BotFather, then click Reconnect on the Telegram install panel and paste the new one.
  • New chat: grab the new chat ID the same way, then paste it in the install panel. You can keep the same bot.
Last updated on