The Official PasterLink Telegram Bot

How the Telegram Paste Bot Works

1. Step 1

   Open the PasterLink bot

   Start the official bot in a private chat and tap Create Paste.

2. Step 2

   Send your content

   Send the text as a normal message. Add a title, a password or button links if you want to, then tap Create.

3. Step 3

   Share your PasterLink URL

   The bot replies with the paste URL, ready to post in a channel, group or chat.

Afterwards, open My Pastes in the bot to edit or delete the pastes you created with it.

No Account Required

Every Telegram user starts in guest mode. You do not need to register on PasterLink to create a paste from Telegram.

• Create a paste through the official bot and receive its PasterLink URL.
• See the pastes you created with the bot under My Pastes.
• Edit or delete those pastes later, from the same Telegram account.
• Guest creation has per-user rate limits to keep the service fair for everyone.

Good to know: a guest paste can be managed only in the bot. Guest pastes created on the website cannot be edited or deleted later.

What the Bot Can Do

• Guest paste creation

  Create a paste without a PasterLink account.

• Creator account connection

  Connect a Creator Mode account with an API key so new pastes belong to it.

• Create

  Turn a Telegram message into a PasterLink paste.

• My Pastes

  Browse your pastes page by page and open any of them.

• Edit

  Replace the content, change or remove the title, and set or remove the password.

• Delete

  Delete a paste after a confirmation step.

• Optional title

  Give the paste a title, or leave it untitled.

• Optional password

  Require a password to open the paste page.

• Links as buttons

  Show the links in your paste as buttons, the same option as on the website.

• Direct PasterLink URLs

  Every paste gets a standard pasterlink.com/paste/ link you can share anywhere.

Share Long Text on Telegram with One Link

A paste turns long content into a single URL. It works well as a lightweight Pastebin alternative for Telegram, when a message is too long or awkward to read in the chat.

• Text that is too long for a message

  Keep the Telegram post short and put the full text on one page that readers open when they need it.

• Channels and announcements

  Post a short announcement and link to the detailed notes, rules or changelog.

• Communities and support

  Share guides, FAQs and troubleshooting steps as one link that admins can point to again and again.

• Creators

  Connect your Creator account so pastes you make in Telegram appear on your PasterLink dashboard, with the analytics that Creator Mode includes.

Telegram is a third-party service and is not affiliated with PasterLink.

Bot and Website Compared

You can create a paste for Telegram in the bot or on the website. This table shows what each way includes.

Security

• Connecting an account uses a PasterLink API key. The bot never asks for your PasterLink email address or password.
• The bot deletes the message that contains your API key as soon as it receives it, when Telegram allows the deletion. If it cannot, it tells you so you can delete the message yourself.
• The bot stores connected API keys in encrypted form. Disconnecting removes the key from the bot.
• Guest pastes are managed through credentials the bot handles internally. You never have to copy or keep a code, and only the Telegram account that created a guest paste can manage it in the bot.
• If you think an API key has been exposed, revoke it on PasterLink under Dashboard → API keys. Disconnecting the bot does not revoke the key.
• The bot works in private chats only, so your API key and paste content are never sent in a group.
• Anyone with a paste link can open the paste unless you add a password. Do not put passwords, private keys or other credentials in a paste. The password prompt is an access gate for the paste page, not end-to-end encryption.

Building Your Own Telegram Bot?

If you run your own bot or script, it can create pastes through the PasterLink Creator Mode API and post the link itself. This needs a Creator Mode account and an API key. Your code creates the paste with POST /api/v1/pastes, reads the returned URL and sends it with the Telegram Bot API. PasterLink never needs your bot token.

import os

import requests

PASTERLINK_API_KEY = os.environ["PASTERLINK_API_KEY"]
TELEGRAM_BOT_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]
TELEGRAM_CHAT_ID = os.environ["TELEGRAM_CHAT_ID"]


def create_paste(title, long_content):
    response = requests.post(
        "https://pasterlink.com/api/v1/pastes",
        headers={
            "Authorization": f"Bearer {PASTERLINK_API_KEY}",
            "Accept": "application/json",
        },
        json={"title": title, "body": long_content},
        timeout=30,
    )
    response.raise_for_status()
    return response.json()["url"]


def send_to_telegram(text):
    response = requests.post(
        f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage",
        json={"chat_id": TELEGRAM_CHAT_ID, "text": text},
        timeout=30,
    )
    response.raise_for_status()


with open("release-notes.txt", encoding="utf-8") as notes:
    long_content = notes.read()

paste_url = create_paste("Release notes", long_content)
send_to_telegram(f"Full release notes: {paste_url}")

• Keep both tokens server-side. Read them from environment variables, and never put them in browser JavaScript, a mobile app or a public repository.
• Only body is required. The title can be up to 255 characters, and body can be up to 500,000 characters.
• Plain text is saved one paragraph per line and URLs become links. If the text contains HTML-style tags, the API treats it as HTML and sanitizes it.
• The Telegram Bot API documents sendMessage text as 1–4,096 characters after entity parsing, so a paste link is a simple way to share longer results. See the official Bot API documentation for current limits.

Frequently asked questions