# Getting Started

##

{% stepper %}
{% step %}

### Install the Bot

* Visit [Discord official Giftoin installation link](https://discord.com/oauth2/authorize?client_id=1217845993513685085)
* Click "Add to Server"
* Select the server where you want to install Giftoin
* Review and approve the requested permissions
  {% endstep %}

{% step %}
**Request Setup Code**

* Join the official [Giftoin Discord](https://discord.gg/9CzbDYc9sV) server
* Open a support ticket in the designated channel
* Request a unique setup authorization code
* The Giftoin support team will provide you with a code specific to your server

{% endstep %}

{% step %}
**Run Setup Command**

* In your server, use the `/giftoin setup {setupCode}` command in any channel
* Enter the setup code when prompted
* The bot will verify permissions and begin the setup process
* Wait for confirmation that setup is complete

{% endstep %}

{% step %}
Private Mode Configuration

* After setup, all Giftoin elements will be created in private mode
* Only server administrators can view the newly created:
  * Giftoin category
  * Specialized channels
  * Role configurations
  * Pinned guide messages
* Review all created elements and make any desired customizations
  {% endstep %}

{% step %}
**Test Bot Functionality**

* Experiment with the available commands (see [Command Reference](/platform-guides/discord/command-reference.md))
* Test giveaway creation and management
* Check inventory and progress tracking
* Ensure all features work as expected before making public
  {% endstep %}

{% step %}
Publish the Bot

* When ready for users to access the bot, run the `/publish` command
* Specify which roles should have access to Giftoin features
* Confirm the publication settings
* The bot will then become visible and usable for members with the specified roles
  {% endstep %}
  {% endstepper %}

<details>

<summary>Server Structure</summary>

* **Admin Channel**: For bot announcements and admin-only communications
* **Guide Channel**: Contains helpful resources and links
* **Giveaways Channel**: Where giveaways are announced and managed
* **General Channel**: For community discussions about Giftoin
* **Trading Channel**: Where members can trade cards and view offers
* **Bingo Channel**: Reserved for future bingo functionality

Note: Administrators can rename these channels after setup without affecting functionality.

</details>


---

# 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.giftoin.org/platform-guides/discord/getting-started.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.