# 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="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2Fu3LyHzZGbkajA0TOwFHb%2Fimage.png?alt=media&#x26;token=c2176575-c057-41c7-8aca-5c19745a6f55" 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="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FgVLgHIDb2isMPJzCMKXv%2Fimage.png?alt=media&#x26;token=3cf81f59-81ff-4012-a9c4-612efa38f52a" alt=""><figcaption></figcaption></figure>

2. They enter their phone number on the next page

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FPKUmwmFEcBaM7HEoeoGU%2Fimage.png?alt=media&#x26;token=ebbb331f-be6a-47ac-8f0f-767c1d4e21b4" alt="" width="344"><figcaption></figcaption></figure>

3. Telegram sends a confirmation message to their Telegram account

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FVCZ9rnJC3uQlMTlmWngN%2Fimage.png?alt=media&#x26;token=d971bf7b-0024-4fea-a262-4eeee33beb10" alt="" width="326"><figcaption></figcaption></figure>

4. The user confirms the request

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FZ3R2ky2G8r2WX3ZhP8Pf%2Fimage.png?alt=media&#x26;token=15f82277-ab6a-4d66-8dca-5d6d099df049" 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="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FsWZHDJEJwuSNerNFFshp%2Fimage.png?alt=media&#x26;token=d8900d8c-bcdd-4a90-9301-e192e8306eb7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FovXk4R8Z0ELmk3YKgLX2%2Fimage.png?alt=media&#x26;token=13c24ab9-fdf3-4d8a-b69b-25ede213bd34" alt=""><figcaption></figcaption></figure>

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