> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/ggwp-discord-bot/onboarding-and-configurations.md).

# Onboarding & Configurations

## General Onboarding Flow

1. You share config settings with GGWP ([see below](#ggwp-discord-bot-configurations))
2. GGWP configures the bot and shares the invitation link
3. You use invitation link to add the bot
4. GGWP enables the bot

After adding the bot, it’s best to wait about two weeks for it to monitor activity and calibrate user reputation scores.&#x20;

Post-onboarding, the following can be fine-tuned as needed:

* [Filter strength](/api-docs-chat/standard-package/chat-api-v2-legacy.md#headers): Can be directly updated using Dashboard as outlined [here](/dashboard-user-guide/admin-features.md#content-filter-configuration).
* Allowlist/blocklist: Can be directly updated using Dashboard as outlined [here](/dashboard-user-guide/admin-features.md#allowlists-and-blocklists). The Chat product lists are shared with both Voice and Discord.
* [Bot Configurations](#other-available-configs)

For a better understanding of what permissions are requested while onboarding the bot via the invitation link, refer: [GGWPBot Permissions](/ggwp-discord-bot/onboarding-and-configurations/ggwpbot-permissions.md).

## GGWP Discord Bot Configurations

#### At least the following configs are required for onboarding:

* Guild/Server ID\*

  Server ID of your Discord Guild where you want the GGWP Discord Bot to be added.
* Admin/Moderator Role IDs\*

  Role IDs of your admin/moderator team who should have access to use the GGWP Admin Commands as listed [here](/ggwp-discord-bot/commands.md#admin-commands). At least one role ID is required to get started and it can be changed later by reaching out to your account manager.&#x20;
* Tenant association (if applicable)

  If you are already a GGWP customer using other services and have multiple tenants/game with GGWP then the tenant name to associate the Discord Bot data to the GGWP Dashboard will also be required.&#x20;

> By default, the Bot runs in silent mode, i.e., it will neither delete any message nor will it sanction any user. It will continue to monitor the ongoing activities and keep adjusting the reputation scores. This can be changed by updating the config settings at any time.

#### Other available configs

All the settings below can be changed at any time by reaching out to your account manager.

* **Member Role IDs**

  By default all the members in your discord community will have the member role and they would be able to use the commands as listed [here](/ggwp-discord-bot/commands.md#member-commands). Discord natively provides control of bot commands and it can be updated by directly using the option of `Integration` under Discord's `Server Settings`.&#x20;
* **Message Deletion**

  This setting controls if the toxic message should be deleted or not. You can select either or both the modes from below:

  * (default) Fast: Live filtering (<0.5s deletion)

    Fast mode does live filtering based on the [settings](/dashboard-user-guide/admin-features.md#content-filter-configuration) available in the dashboard.
  * Slow: Using contextual AI models (\~1s deletion)

    You can also choose to delete messages that our contextual AI models flag as inappropriate. We generally recommend completing this step after the bot runs for a couple of weeks. Your account manager can work with you to define custom rules for message deletion based on factors like severity, incident type, user reputations score etc.
* **Posts Deletion**

  Allows the discord bot to remove Discord posts in Discord [forum channels](https://support.discord.com/hc/en-us/articles/6208479917079-Forum-Channels-FAQ) using live filtering responses. Only fast message deletion is supported for posts. By default this setting is off.
* **Automod**

  By default automoderation is switched off. Please reach out to your account manager to discuss automod configuration and to switch it on.

## How to get Discord Server ID and Role IDs

For the server ID and the role IDs, you need to enable the Developer Mode in your Discord first.&#x20;

#### **Enabling Developer Mode**

1. Open Discord: and click the cogwheel icon for User Settings in the bottom-left corner of the app.
2. Navigate to the Advanced tab in the left-hand menu.
3. Find Developer Mode and toggle it on.
4. Close: User Settings.

{% embed url="<https://www.youtube.com/watch?v=rpdKJf1BKdI>" %}

#### Getting Discord Server ID

1. In your server list on the left, right-click on the icon of the server you want the ID for.
2. From the context menu that appears, select "Copy ID".

{% embed url="<https://www.youtube.com/watch?v=PhPekZg4q7E>" %}

#### Getting Role IDs

Admin/Moderator role IDs are for the roles to which you would like to provide access to the admin commands of GGWP Discord bot. You can get it as follows:

1. In the server where the role is located, click on the "Server Name" header at the top-left.
2. Select "Server Settings".
3. Go to the Roles tab in the left-hand menu.
4. Locate the specific role you need.
5. Right-click: on that role.
6. Select "Copy ID" from the context menu.

{% embed url="<https://www.youtube.com/watch?v=3YyUIpilU7g>" %}
