# Telegram

Follow these steps to integrate Telegram within the Advocate Dashboard:

#### Create a Bot with BotFather

1. Open Telegram and search for BotFather
2. Start a chat and send the command: **/newbot**
3. Follow the instructions:

* Provide a name for your bot
* Choose a username (must end in "bot", e.g. MyReferralBot)

4. Once set up, BotFather will generate a bot token

#### Add the Bot as an Administrator to Your Channel

1. Open your Telegram channel
2. Tap the three-dot menu in the top-right corner
3. Select "Manage Channel"
4. Click "Administrators"
5. Select "Add Administrator" and choose the bot created in Step 1
6. Save the changes

#### Connect Your Bot to the Advocate Dashboard

1. Go to Widget Builder > Advocate Dashboard > Dashboard
2. Add the "Social Actions" element
3. In the "Telegram Text Customization" section:

* Enter your bot token in "Telegram Bot Token"
* Provide your "Telegram Invite Link"

<figure><img src="/files/8o1Z0UZGc7wy7Era3FQt" alt=""><figcaption></figcaption></figure>

4. Save the changes

#### User Experience

1. The user clicks the Join Telegram button on the Advocate Dashboard

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

2. They enter their phone number on the next page

<figure><img src="/files/84GsnvNpoquAKe9HxxHR" alt="" width="344"><figcaption></figcaption></figure>

3. Telegram sends a confirmation message to their Telegram account

<figure><img src="/files/FErOCQ1PEoQrZaeJzpL7" alt="" width="326"><figcaption></figcaption></figure>

4. The user confirms the request

<figure><img src="/files/4ZxtXcGeYX08J86o7XC6" alt="" width="309"><figcaption></figcaption></figure>

5. The user successfully joins the group
6. The "Join" button on the Dashboard updates to a checkmark

<figure><img src="/files/2p7FJOSWHpUww3twB22H" alt=""><figcaption></figcaption></figure>

7. "Joined Telegram Channel verified" is logged in the subscriber's profile on your admin dashboard

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

8. If points are assigned for joining Telegram, the user earns them automatically


---

# 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://support.referralhero.com/campaign-builder/integrations/telegram.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.