> For the complete documentation index, see [llms.txt](https://docs.imber.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imber.dev/imber-bot/setup-guides/bot-setup.md).

# Bot Setup

{% hint style="danger" %}
Please follow the entire setup guide. Your bot won't be activated if you skip the steps below.
{% endhint %}

## Bot Creation

1. Go to the Discord **Developer Portal.**

{% embed url="<https://discord.com/developers/applications?new_application=true>" %}

2. Log in with your Discord Account and select the button '**New Application**'.

<figure><img src="/files/PTrY1PsThqQpIxWBlVZq" alt=""><figcaption><p>New Application</p></figcaption></figure>

3. Then enter the name you want your bot to be called and click '**Create**'.

<figure><img src="/files/du07HmS1E0zZ4MvPPnwc" alt=""><figcaption><p>Create a Bot</p></figcaption></figure>

## Installation Options

1. Locate the '**Installation**' tab on the left side.

<figure><img src="/files/y9FQWe2wVZtuh5tubUB4" alt=""><figcaption><p>Installation Options</p></figcaption></figure>

2. Set the options as seen above in the image

{% hint style="warning" %}
You must use the options seen above, your bot won't activate without them!
{% endhint %}

## Bot Token

1. Locate the '**Bot**' tab on the left side.

<figure><img src="/files/TDHZ9yuxbXVPEf609pa7" alt=""><figcaption><p>Reset Bot Token</p></figcaption></figure>

2. Get the '**Bot Token**' by clicking '**Reset Token**' followed by **'Yes, do it!'**.&#x20;
3. Click '**Copy**' to copy the bot token.

<figure><img src="/files/ymZunhfgMvGW0HugWVU7" alt=""><figcaption><p>Copy Bot Token</p></figcaption></figure>

{% hint style="info" %}
Save the '**Bot Token**' temporarily. This is required later to activate your bot!
{% endhint %}

## Required Intents

1. Scroll down on the '**Bot**' tab and set the options as seen in the image below.

<figure><img src="/files/Dfotpjuhu0YyweAlLvFx" alt=""><figcaption><p>Required Intents</p></figcaption></figure>

{% hint style="warning" %}
You must use the options seen above, your bot won't activate without them!
{% endhint %}

## Client Secret

1. Locate the '**OAuth2**' tab on the left side.

<figure><img src="/files/2WiwLr6oB8jhO7denk79" alt=""><figcaption><p>Reset Client Secret</p></figcaption></figure>

2. Get the '**Client Secret**' by clicking the '**Reset Secret**' button.
3. Click '**Copy**' to copy the client secret.

<figure><img src="/files/BwWgPauL6k8TjF5MPJFm" alt=""><figcaption><p>Copy Client Secret</p></figcaption></figure>

{% hint style="info" %}
Save the '**Client Secret**' temporarily! This is required later to activate your bot!
{% endhint %}

## Redirect URLs

1. On the '**OAuth2**' page, add the Redirect URI by clicking the '**Add Redirects**' button.
2. Set the **two redirect URIs** seen below and click **save changes**.

{% code fullWidth="false" %}

```
https://api.imber.cc/oauth2/verify
```

{% endcode %}

```
https://api.imber.dev/oauth2/verify
```

<figure><img src="/files/MAsmMMagoVzjA7ptXmZ2" alt=""><figcaption><p>Required Redirects</p></figcaption></figure>

## Dashboard

1. Go to the **Imber Dashboard**.

{% embed url="<https://imber.dev/my-account/bots/>" %}

2. Log in with your Imber account and click the button '**CREATE**'.

<figure><img src="/files/gaz2buGOuFGmsLAd9ft2" alt=""><figcaption><p>New Bot</p></figcaption></figure>

3. Paste your '**Bot Token**' and '**Client Secret**' and click **'CREATE BOT'.**

<figure><img src="/files/piBGjLhQwRV8NatLJxzi" alt=""><figcaption><p>Create Bot</p></figcaption></figure>

4. Invite your bot to a server by clicking the '**Invite**' button

<figure><img src="/files/TKhDoYzgSAXDGCPb3miH" alt=""><figcaption><p>Invite Bot</p></figcaption></figure>

{% hint style="success" %}
You now have successfully created your custom Discord bot!
{% endhint %}

{% content-ref url="/pages/zYDGeVTvmLw2JkPkf5Jz" %}
[Customization](/imber-bot/customization.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.imber.dev/imber-bot/setup-guides/bot-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.