# Telegram Setup

Getting Mava to work with your Telegram is a simple process that won’t take more than 5 minutes. Make sure you have a telegram account before you get started. When ready head over the the integrations page on the [Mava dashboard here.](https://dashboard.mava.app/dashboard/admin/integrations/)

### **Step 1: Create your Telegram bot**

1. Open ‘BotFather’ via this link: \*\*<https://telegram.me/BotFather**> and follow the link to Telegram. Once in Telegram press the **Start** button under the welcome message.

*(**What’s ‘BotFather’?** BotFather is Telegram’s own bot that is used to install new bots and manage existing bots)*

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

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

2. After hitting the Start button, you will see the message below. Click /newbot and choose a name for the bot.

<figure><img src="/files/6bqKRmx1XT1UdOlVVbdi" alt=""><figcaption></figcaption></figure>

3. Now you need to name your bot. Think of your name and type it as a message. Pssst. "MavaExplainer" is just an example 🤓, come up with your own.

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

4. Now you need to choose a username for your bot. This will be visible to your end users and should be something clear, for example:

*\[your organization’s name]\_TicketBot*

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

5. Nice job, your bot has been created 😎. Now you need to copy the HTTP API token (hidden behind the green box below).

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

### Step 3: Verify your HTTP API token

1. Go back into Mava
2. Paste your unique HTTP API token, from the previous step, into the ‘Verify your token’ field on the Mava dashboard.

### Step 4: Update the logo and bio information

Within the BotFather Telegram channel type /mybots then press the Edit Bot button. Here you can add information about your bot and update the logo.

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

### Step 5: Give the right permissions to the bot

Go back to the bot main menu and press the Bot Seetings button, then go to Group Privacy and press the Turn off button to disable Privacy mode. This will allow your bot to read messages in your group and answers to users.

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

### Step 6: Add your new bot to your group and educate your users

1. Go into the Telegram group where you want users to be able to create a support ticket and add your bot as a group member (Your bot will be called something else!)

<figure><img src="/files/1n80kAixd2uTj9oI4Qmg" alt=""><figcaption></figcaption></figure>

2. After you bot is added to the group we suggest adding it to your bio page. You need to add the full Telegram link here ‘t.me/\[your bot name]’ as per the below screenshot. You can find this link within your ‘BotFather’ Telegram channel.

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

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

### Step 7: Create a Telegram test ticket

1. Find your bot among the members in the group and click on it
2. Click the 'Message' button to open a direct conversation with the bot
3. Use the /start command to create a ticket

For help with setting up or using the Mava Telegram bot, please either join our [Discord](https://discord.gg/GsJrrFbRHC) and open a support ticket in the ‘Contact-Us’ channel OR create a support ticket via our [Telegram bot here](https://t.me/+pFdPxKIOSwAyMDBk)


---

# 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://mava.gitbook.io/mava-docs/getting-started/integration-setup/telegram-setup.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.