# Invite and configure OxyBot on Discord

{% hint style="info" %}
OxyBot lets you control your Oxygenserv services from Discord. The connection is made via an **API key**.
{% endhint %}

### Objective

Invite OxyBot to your Discord server. Link your account via an Oxygenserv API key. Configure language and permissions. Test the commands.

### Step-by-step guide

{% stepper %}
{% step %}
**Invite OxyBot to your Discord server**

Recommended method: dashboard → **My profile** → **OxyBot setup**. A pop-up window displays useful information.

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

You can also use the direct invitation link: [Invite OxyBot](https://discord.com/oauth2/authorize?client_id=1107672334590025878\&scope=bot\&permissions=537201728)
{% endstep %}

{% step %}
**Retrieve your Oxygenserv API key**

Retrieve the API key from the pop-up window. Copy it.

<figure><img src="/files/0490ddbf0884f8e76d90349891eff3d40284f8f9" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Never share your **API key**. It grants access to manage your servers via the bot.
{% endhint %}
{% endstep %}

{% step %}
**Link the API key to OxyBot**

On your Discord, run:

* `/setup api`

Then paste your API key into the window.

<figure><img src="/files/9b45512029d6cd2f8ccff8a24bfc8758e45cc584" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Choose the bot language**

Run:

* `/setup language`

Choose **French** or **English**.
{% endstep %}

{% step %}
**Configure Discord permissions**

By default, sensitive commands are restricted. This is intentional. It prevents accidental misuse.

In Discord:

* **Server Settings**
* **Integrations**
* OxyBot → **Manage**

<figure><img src="/files/8e168590fa50d564c4a502bfe892fabb002ef029" alt=""><figcaption></figcaption></figure>

You can manage:

* allowed channels,
* allowed roles,
* command access.

<figure><img src="/files/c53de880b44cbf94fa1260ee287dd2b6f2921027" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Test the bot**

Test with:

* `/server` for a server
* `/servers` for the list
  {% endstep %}
  {% endstepper %}

#### Give a non-admin role access to a command

In command permissions, add a role (e.g.: `mod`) on a command. Example: allow `/restart` for `mod` and `Administrator`. Keep a dedicated channel if possible.

<figure><img src="/files/0e6580a6df829af97bf9e4de0e07ccc4c017f11f" alt=""><figcaption></figcaption></figure>

Official Discord guide: [Command permissions](https://support.discord.com/hc/fr/articles/4644915651095-Permissions-de-Commandes)

### Common issues

#### Commands do not appear

* Check that the bot is indeed on the server.
* Check that the integration has the correct permissions.
* Try again after a few minutes (Discord sync).

#### I don’t have access to a command

* Check your Discord roles.
* Check the command permissions (Integrations → OxyBot → Manage).

#### I think my API key leaked

* Notify support immediately.

### FAQ

#### Why is everything blocked for @everyone?

To prevent a member from running a sensitive command. Allow only the necessary roles.

#### Can I limit the bot to one channel?

Yes. Allow commands only in a dedicated channel.


---

# 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.oxygenserv.com/en/dashboard/inviter-et-configurer-oxybot-sur-discord.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.