# Heimdall set-up

#### ⚙️ How to Add Heimdall to Your Telegram Group

Adding Heimdall `(@heimdall_odintools_bot)` to your Telegram community takes less than a minute. Once active, it automatically protects your group from spam, scams, and malicious users - and connects you to the global Heimdall protection network.

#### Setup

1. **Invite Heimdall Bot**
   * Open the official **Heimdall Bot** link: t.me/heimdall\_odintools\_bot \
     (Username: @heimdall\_odintools\_bot)
   * Click **“Add Bot to Group”** and choose your Telegram community.
2. **Grant Admin Permissions**\
   Heimdall needs admin rights to ban, mute, and delete susspicious messages.\
   Make sure the following permissions are **enabled**:
   * Delete messages
   * Ban users
   * Restrict users
   * Pin messages (optional)
3. **Confirm Activation**\
   Once added, Heimdall will send a confirmation message in your group showing it’s active and synced with the global network.
4. **Done. You’re Protected.**\
   That’s it - your group is now part of the **Heimdall Network**.\
   From this point, any spammer banned anywhere in the network will automatically be banned in your group too.

{% embed url="<https://youtu.be/r_ipw5Rp7Zc?si=-pIlYEY3363nST8Y>" %}

#### 🛡️ Optional Settings

* `/help` – See more options
* `/settings` – View and adjust moderation preferences.
* `/stats` – See your group’s protection data.
* `/info @username` - View user ID, recent suspicious messages, and status.

***

Adding Heimdall early to your community helps prevent infiltration before your project grows. Every new group strengthens the overall shield - so when you protect your chat, you help protect thousands of others.


---

# 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.odin.tools/tools/heimdall-protection-bot/heimdall-set-up.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.