# Giveaway Bot

To begin, please ensure that the Vulcan Authentication role has the following permissions in your server. It must be able to see your desired support channels. *<mark style="color:red;">**Double-check your channel overrides to ensure Vulcan has sufficient access to broadcast the support ticket webhook. A warning will appear on the setup screen if Vulcan lacks sufficient permissions and the configuration cannot be saved. You can find how to set up channel permissions under the**</mark>* [*<mark style="color:purple;">**Getting Started**</mark>*](https://help.vulcan.xyz/getting-started) *<mark style="color:red;">**document section.**</mark>*

## Creating Giveaways

### Discord Setup

To create a giveaway manually from the Discord client use the command `!vcreate {time | s/m/h} {winners} "Prize"` . Example setup and flow.

<figure><img src="/files/NXYmPfOlYvvax8XXshbP" alt=""><figcaption></figcaption></figure>

### Dashboard Setup

Start by navigating to the 'Giveaways' option on the left side menu of your Vulcan Dashboard.

<figure><img src="/files/WBmpA5xyqexZfOSFw5dg" alt=""><figcaption></figcaption></figure>

Then select Add Giveaway, and fill out the Add New Giveaway configuration.

<figure><img src="/files/jIHOE8YDGIZxEbVzxBwO" alt=""><figcaption></figcaption></figure>

For ease of use on 'End time' select the calendar on the right-hand side of the entry box.

<figure><img src="/files/iBVGJeVi3tHgxRpwK0IV" alt=""><figcaption></figcaption></figure>

Review & continue then select which channel the giveaway should be posted in. Finally, verify all parameters are correct and select 'Launch Giveaway'.

<figure><img src="/files/7ch8VMBSOlfwwoPZZaz3" alt=""><figcaption></figcaption></figure>

## How Users Enter Giveaways&#x20;

Once saved you're ready to go. Below is an example flow.

<figure><img src="/files/lyA69V2oYlaJvqEQuLnO" alt=""><figcaption><p>After entry you are able to update wallet address as well as delete giveaway entry.</p></figcaption></figure>

## Picking Winners

All entries at draw time will be counted and winners are selected at random.

## Viewing Giveaways / Entries

After your first giveaway is created when returning to the Giveaway Bot section of your dashboard, you will be able to view all active and previous giveaways.

<figure><img src="/files/wkMKZn2jyXr7UM3F3JOf" alt=""><figcaption></figcaption></figure>

## Getting Wallet Addresses

After a giveaway has finished you can select the giveaway with the status 'Winners Picked' from your dashboard. Then select the 'Winner' toggle at the top right. You have 2 options on how to collect wallets. You can export at the top right for a CSV of all winning wallets as well as copy manually next to each user.

<figure><img src="/files/D77dpxPFH7fVSoGQkHca" alt=""><figcaption></figcaption></figure>


---

# 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://premint.gitbook.io/vulcan/products/bots/giveaway-bot.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.