# Telegram (Bot + Chat)

{% hint style="info" %} <sub>Bots are polite machines. Humans still need a clear channel id or thread discipline, or you will ship noise.</sub>
{% endhint %}

<h2 align="center"><sub>This page means</sub></h2>

<table><thead><tr><th width="299.45452880859375">This page is</th><th>This page is not</th></tr></thead><tbody><tr><td><sub>Operator guidance for the bot token slot</sub></td><td><sub>Telegram’s full Bot API reference</sub></td></tr><tr><td><sub>Save, Test, rotate habits</sub></td><td><sub>A promise that every message will deliver instantly</sub></td></tr></tbody></table>

<h3 id="how-to-get-a-github-api-key-for-aria" align="center"><sub>How to get a Telegram Bot Token key for ARIA</sub></h3>

{% stepper %}
{% step %} <sub>**Open BotFather in Telegram**</sub>

<sub>Install Telegram on a device you trust. Search for</sub> [<sub>@BotFather</sub>](https://t.me/BotFather) <sub>and click</sub> <sub></sub><sub>**Start**</sub><sub>.</sub>\
![](/files/4nmSWrjEdzUNffXaWFk8)\
![](/files/JisSEtXuaa1GQdpQ52oY)
{% endstep %}

{% step %} <sub>**Create a new bot**</sub>&#x20;

<sub>Send</sub> <sub></sub><sub>`/newbot`</sub> <sub></sub><sub>or use the UI (Click Open). Follow prompts for display name and username (username must end in</sub> <sub></sub><sub>`bot`</sub><sub>). BotFather replies with an HTTP API token.</sub>\
![](/files/VnlmWKvhHLDTjndgdZjc)![](/files/Uyl35zf5KL7VCdJcwLyp)![](/files/I0Dei1cec0HqcMs9T58U)![](/files/7BsP7Xmjbtq1Ps7Tb5e1)
{% endstep %}

{% step %} <sub>**Copy the token once**</sub>

<sub>Copy the full string. Do not post it in a group chat or ticket. If it leaks, send</sub> <sub></sub><sub>`/revoke`</sub> <sub></sub><sub>to BotFather for that bot, get a new token, then update ARIA.</sub>
{% endstep %}

{% step %} <sub>**Add the bot to your destination chat (optional for this step but recommended)**</sub>

<sub>For alerts, you still need a</sub> <sub></sub><sub>**Telegram chat id**</sub> <sub></sub><sub>and you must add the bot to that group or channel with permission to post. See the chat id how to.</sub>
{% endstep %}

{% step %} <sub>**Paste in ARIA Settings**</sub>

<sub>Open</sub> <sub></sub><sub>**Telegram Bot Token**</sub><sub>, paste,</sub> <sub></sub><sub>**Save**</sub><sub>, then</sub> <sub></sub><sub>**Test**</sub><sub>. Success should echo the bot username.</sub>

***

{% endstep %}
{% endstepper %}

<h2 align="center"><sub>Ask a question</sub></h2>

<p align="center"><sub><strong>Which Telegram room should wake someone up at night, and which should never ping leadership?</strong></sub> <br><sub>Name both before you wire alerts.</sub></p>

<h2 align="center"><sub>Official Telegram links</sub></h2>

<table><thead><tr><th width="284.9090576171875">Resource</th><th>URL</th></tr></thead><tbody><tr><td><sub>BotFather (create bots and tokens)</sub></td><td><a href="https://t.me/BotFather"><sub>https://t.me/BotFather</sub></a></td></tr><tr><td><sub>Telegram Bot API introduction</sub></td><td><a href="https://core.telegram.org/bots"><sub>https://core.telegram.org/bots</sub></a></td></tr><tr><td><sub>Bot FAQ</sub></td><td><a href="https://core.telegram.org/bots/faq"><sub>https://core.telegram.org/bots/faq</sub></a></td></tr></tbody></table>

***

<h3 align="center">Telegram Chat ID</h3>

<p align="center">A bot can be healthy and still whisper into the void if the chat id is wrong.</p>

{% hint style="info" %} <sub>Treat chat id like a postal code. The bot is the mail truck. The id is the house number.</sub>
{% endhint %}

{% hint style="info" %} <sub>Supergroups and channels often use negative ids (for example -1001234567890). ARIA may auto test common variants; still paste the exact value your tool reports.</sub>
{% endhint %}

<h2 align="center"><sub>Build a fence</sub></h2>

<table><thead><tr><th width="232.18182373046875">This page is</th><th>This page is not</th></tr></thead><tbody><tr><td><sub>Operator guidance for routing</sub></td><td><sub>A full Telegram moderation playbook</sub></td></tr><tr><td><sub>Save, Test, naming rooms</sub></td><td><sub>A guarantee that every alert will be actionable</sub></td></tr></tbody></table>

<h3 align="center"><sub>How to get your chat id for ARIA</sub></h3>

{% stepper %}
{% step %} <sub>**Create or choose the target chat**</sub>

<sub>Decide whether alerts go to a private chat with your bot, a group, or a channel. Name the room so humans do not confuse prod and sandbox.</sub>\
![](/files/xD8yQuKnoh5jnY1iKFZ9)![](/files/iOUGrR2C343AvqYE7z53)
{% endstep %}

{% step %} <sub>**Add your ARIA bot to the chat**</sub>

<sub>Add the bot from your bot token setup. Grant permission to send messages. In channels, make the bot an admin if posting is required.</sub>\
![](/files/n2VvCiGKR0WnWvA4gaxE)![](/files/IfsftiySjqavy2WD5Iyw)\
![](/files/wktbreKrO5QYhkNFQdOY)![](/files/s9PCMKrnjK4HrBk2yawn)
{% endstep %}

{% step %} <sub>**Obtain the numeric chat id**</sub>&#x20;

<sub>Common pattern: forward a message from that group or channel to</sub> [<sub>@JsonDumpBot</sub>](https://t.me/JsonDumpBot)<sub>, then read</sub> <sub></sub><sub>`id`</sub> <sub></sub><sub>from the JSON. For supergroups, prefer the</sub> <sub></sub><sub>`-100…`</sub> <sub></sub><sub>form when that is what the tool returns.</sub>\
![](/files/Eui7BG9T2x9IRVMWGFhM)<br>
{% endstep %}

{% step %} <sub>**Paste digits only in ARIA**</sub>

<sub>In ARIA</sub> <sub></sub><sub>**Settings**</sub><sub>, open</sub> <sub></sub><sub>**Telegram Chat ID**</sub><sub>, paste the numeric id (no extra words),</sub> <sub></sub><sub>**Save**</sub><sub>, then</sub> <sub></sub><sub>**Test**</sub><sub>. You should receive a test message in that room.</sub>
{% endstep %}
{% endstepper %}

***

<h2 align="center"><sub>Ask a question</sub></h2>

<p align="center"><sub><strong>If an alert fired right now, who is on call and what is the first action they take?</strong></sub> <br><sub>If nobody knows, fix humans before you tune bots.</sub></p>

<h3 align="center"><sub>Helpful Telegram bots (third party)</sub></h3>

<table><thead><tr><th width="161.727294921875">Bot</th><th width="209.36358642578125">URL</th><th>Typical use</th></tr></thead><tbody><tr><td><sub>getidsbot</sub></td><td><a href="https://t.me/getidsbot"><sub>https://t.me/getidsbot</sub></a></td><td><sub>Shows your user id and often chat context when forwarded a message</sub></td></tr><tr><td><sub>JsonDumpBot</sub></td><td><a href="https://t.me/JsonDumpBot"><sub>https://t.me/JsonDumpBot</sub></a></td><td><sub>Forward a message to inspect JSON including chat id</sub></td></tr><tr><td><sub>userinfobot</sub></td><td><a href="https://t.me/userinfobot"><sub>https://t.me/userinfobot</sub></a></td><td><sub>User and chat hints (availability may vary)</sub></td></tr></tbody></table>

<p align="center"><sub>Telegram does not give one official “copy chat id” page.</sub> <br><sub>These bots are widely used; still treat any bot as third party and avoid pasting secrets into them.</sub></p>

<table><thead><tr><th width="299.45458984375">Resource</th><th>URL</th></tr></thead><tbody><tr><td><sub>Bot API, getUpdates (shows chat objects)</sub></td><td><a href="https://core.telegram.org/bots/api#getupdates"><sub>https://core.telegram.org/bots/api#getupdates</sub></a></td></tr></tbody></table>


---

# 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://docs.ariaagi.com/settings-and-integrations/telegram-bot-+-chat.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.