> For the complete documentation index, see [llms.txt](https://support.referralhero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.referralhero.com/campaign-builder/integrations/telegram.md).

# 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