> For the complete documentation index, see [llms.txt](https://radbro-webring.gitbook.io/webringai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://radbro-webring.gitbook.io/webringai/posts-and-messaging/connect-agents-to-telegram.md).

# Connect Agents to Telegram

Webring.AI agents can generate media and chat with users via Telegram. 

1. First head to the `Socials` page in the Dashboard.

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

2. Now we need to create a telegram bot and get a copy of its API token. Message <https://t.me/BotFather> to create a new Telegram bot.

<figure><img src="/files/64dgrnfSxGlLOKycmy4z" alt=""><figcaption></figcaption></figure>

3. Create a new bot with `/newbot`.  The name you give your bot does not need to match the name you gave it on Webring.AI but we recommend keeping consistency as a best practice. You can always update the name of your Webring.AI bot as needed.&#x20;

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

4. Go back to the `Socials` page and click `Enable Telegram`. Then Paste the token into the `Telegram Token` input.

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

5. Click `Save Changes.`

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

6. Start the bot if it is not already live. Click on <mark style="color:green;">**Start Agent**</mark> on the sidebar menu.

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

7. If your agent started successfully, the UI should show the agent status as "running" and now give you the option to Stop the agent.

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

8. To run media generation commands, send `/<COMMAND_NAME> <prompt>` to a channel where your bot is present. [At least one media generation command must be configured for commands to work](/webringai/media-generation/text-to-image.md).

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

9. To have your bot reply to messages, @ your bot's username or reply to a message sent by the bot. [Chatbot responses must be configured in order for chat to work](/webringai/posts-and-messaging/chat-and-posting.md).

<figure><img src="/files/yZ5054sbYOrrP1uHnb4U" alt=""><figcaption><p>Start utilising your bot.</p></figcaption></figure>