# Telegram Integration

## Prerequisite – Set Up Your Product

Beforehand, make sure to create a paid product in this section and finish by integrating it via Telegram.\
[First Payment in 2 Minutes](/documentation/getting-started/first-payment-in-2-minutes.md)

#### Understanding the Telegram setup & bot flow

To activate paid access on Telegram, the setup happens **between Suby and the Telegram bot**.\
You’ll first link your Telegram account, then publish your product, and finally activate everything directly from the bot.

## Step 1 - Connect your Telegram account

* Open the Suby Telegram bot using the button below
* This step links your Telegram account to Suby
* Once the linking is complete, come back on the platform to continue

<figure><img src="/files/wpc1dAD91IjTZELU0hRR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/x6y7ZoqtfnZPcc5CkunP" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/OiSVAduAsfraIRzUhJ17" alt=""><figcaption></figcaption></figure>

## Step 2 - Publish the product

* Once your telegram is linked, publish your product on the platform
* This step is mandatory to enable Telegram paid access
* Without publishing, the bot cannot activate the product

<figure><img src="/files/D2QhRhsV0UkSPzIHtUCd" alt=""><figcaption></figcaption></figure>

## Step 3 - Activate the product on Telegram

* Go back to Telegram
* Open the Suby bot and type **/start**
* Follow the steps displayed by the bot to finalize the setup:

<figure><img src="/files/wsl1mYUjFvDfSDkHY5b5" alt="" width="375"><figcaption></figcaption></figure>

* Click on "Create Paid Access"

<figure><img src="/files/AfgU604Y9CZiRUQvs0Km" alt="" width="375"><figcaption></figcaption></figure>

* Add the Suby bot to your private group or private channel. This is the access that the Suby bot will gate. Make sure to grant it the required permissions listed below, without these permissions, the bot won’t be able to manage member entry and removal.

<figure><img src="/files/X0AjQacoweHFu49A2zeZ" alt="" width="328"><figcaption></figcaption></figure>

* Once, and only after, the bot has been added to the group or channel, you need to go back to the bot and type `/setup`. This step is essential to link a paid product to the gated group or channel.

<figure><img src="/files/h9aIFOhs45Thtn1VxJei" alt="" width="375"><figcaption></figcaption></figure>

* You should normally see all the plans you previously created on the Suby.fi platform. You can now choose which one you want to associate with your gated group or channel.

<figure><img src="/files/NIVHqnr7BgQZgZA3w0mH" alt="" width="375"><figcaption></figcaption></figure>

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

* Use the direct paylink
* Create and use a public portal (optional)

To create a portal [Optional: Public Portal](/documentation/platform-integration/telegram/optional-public-portal.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://suby.gitbook.io/documentation/platform-integration/telegram/telegram-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.