> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.suby.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Integration Setup

> Connect your Telegram group or channel to Suby and start gating access in minutes.

This guide walks you through connecting your Telegram group or channel to Suby. The setup happens between the Suby dashboard and the Suby Telegram bot, follow the steps in order.

<Card title="Haven't created a product yet?" icon="bolt" href="/v2/docs/introduction/quickstart">
  Follow the Quickstart guide to set up your first product in under 2 minutes.
</Card>

## Setup

<Steps>
  <Step title="Connect your Telegram account">
    Open the Suby Telegram bot and follow the linking flow. This connects your Telegram account to your Suby dashboard.

    Once the linking is complete, come back to the platform to continue.

    <Frame>
      <img src="https://mintcdn.com/suby/Ggx4HrbduwEPUnAn/images/telegramdash.png?fit=max&auto=format&n=Ggx4HrbduwEPUnAn&q=85&s=103dfc7778d14c880e9779048730bd3e" alt="Telegramdash" width="2262" height="1052" data-path="images/telegramdash.png" />
    </Frame>
  </Step>

  <Step title="Publish your product">
    Once your Telegram account is linked, publish your product from the Suby dashboard.

    <Note>
      Publishing is required before the bot can activate the product. The bot cannot gate access to an unpublished product.
    </Note>
  </Step>

  <Step title="Activate the product on Telegram">
    Go back to the Suby Telegram bot and type **/start**. Follow the steps displayed by the bot.

    Click **Create Paid Access**.

    <Frame>
      <img src="https://mintcdn.com/suby/KddbSnyuROOMFQUj/images/TelegramIntegration6.png?fit=max&auto=format&n=KddbSnyuROOMFQUj&q=85&s=aee54736ad2093cce0565069a5b8278c" alt="Telegram Integration6" style={{ width:"56%" }} width="768" height="1168" data-path="images/TelegramIntegration6.png" />
    </Frame>
  </Step>

  <Step title="Add the Suby bot to your group or channel">
    Add the Suby bot to the private group or channel you want to gate, and grant it the required admin permissions.

    <Frame>
      <img src="https://mintcdn.com/suby/KddbSnyuROOMFQUj/images/TelegramIntegration7.png?fit=max&auto=format&n=KddbSnyuROOMFQUj&q=85&s=6e97c0a9b704d746a1b6d26e88a43057" alt="Telegram Integration7" style={{ width:"52%" }} width="656" height="1266" data-path="images/TelegramIntegration7.png" />
    </Frame>

    <Warning>
      Without the correct permissions, the bot will not be able to manage member entry and removal. Make sure to grant admin rights before continuing.
    </Warning>
  </Step>

  <Step title="Link your product to the group or channel">
    Once the bot is added, go back to the bot and type **/setup**. Select the product you want to associate with your gated group or channel.

    <Frame>
      <img src="https://mintcdn.com/suby/KddbSnyuROOMFQUj/images/TelegramIntegration8.png?fit=max&auto=format&n=KddbSnyuROOMFQUj&q=85&s=c2c34cf0fdcbf7d12d5fa8b9fc13e97b" alt="Telegram Integration8" style={{ width:"52%" }} width="762" height="1014" data-path="images/TelegramIntegration8.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/suby/KddbSnyuROOMFQUj/images/TelegramIntegration9.png?fit=max&auto=format&n=KddbSnyuROOMFQUj&q=85&s=08cbfc580655d95cc89380b8785569ab" alt="Telegram Integration9" style={{ width:"52%" }} width="760" height="1080" data-path="images/TelegramIntegration9.png" />
    </Frame>

    <Note>
      Run /setup only after the bot has been added to the group or channel. Running it before will not work.
    </Note>
  </Step>
</Steps>

## You're Live

Once the link between Suby and your private community is complete, you have two options to share access:

<CardGroup cols={2}>
  <Card title="Direct PayLink" icon="link">
    Share your PayLink directly with your audience. Customers pay and receive access instantly.
  </Card>

  <Card title="Checkout (Optional)" icon="globe" href="guides/telegram/checkout">
    Create a public-facing checkout page for your Telegram community.
  </Card>
</CardGroup>