> ## Documentation Index
> Fetch the complete documentation index at: https://fyre.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy Guide

> Learn how to configure privileged intent proxying for your server.

<Warning>
  Privileged intent proxying isn't available yet, as Fyre still has the Message Content intent for a short while more.
  An announcement will be posted when intent proxying is required.
</Warning>

## Why?

Unfortunately, Discord has repeatedly denied our applications for the
[Message Content privileged intent](https://docs.discord.com/developers/events/gateway#message-content-intent).

Many of Fyre's features require the Message Content intent to function.
Without the intent, Fyre doesn't have the required message data to provide these features.

#### Affected Features

The following features require the Message Content intent, and won't fully work without some form of proxying:

* [Text Commands](../syntax)
* [Ticket Transcripts](../modules/tickets/general)
* [Message sniping](../modules/snipe)
* [Channel media mode](../modules/media)
* [VIP auto responses (custom triggers only)](../modules/vip)
* [Automatic time conversion](../modules/time)
* [Server auto responses](../modules/responses)

## How it Works

Privileged intent proxying uses custom bots to forward specific gateway events to Fyre,
allowing servers to continue using features that rely on the Message Content intent (see above).

## Requirements

Fyre has 2 modes available for privileged intent proxying.
Each of these modes has it's own requirements.

#### Partnered Apps

If you have one of our partnered bots in your server, you can use it for proxying for free, regardless of your server's size.

Available partnered apps will be listed when using `/config proxy` in your server.

<Tip>
  Please check the partnered app list before subscribing to Custom App Proxying, as you might not need it.
</Tip>

#### Custom App

By default, all Discord apps (bots) can access Message Content when they have less than 10,000 total users.
Your app's user count is the total members of each server on your bot combined.

If your server has less then 10,000 members, you can use the custom bot proxying mode.
If your server has more then 10,000 members, you **cannot** use custom bot proxying,
unless your app is approved for the Message Content privileged intent.

## Configuring

To configure privileged intent proxying in your server, use `/config proxy`.
If you select the "Custom App" mode, you'll need to provide your bot's token in the command.

If you have any of our partnered apps in your server, you'll see them listed as options with the "(Partner)" label.
If you select a partnered app, you don't need to do anything else.

#### Custom App Setup Instructions

Follow these instructions to use a custom bot for privileged intent proxying.

<Steps>
  <Step title="Open the Discord Developer Portal">
    In your browser of choice, visit [https://discord.com/developers/applications](https://discord.com/developers/applications).
    Once there, make sure you're logged into your Discord account.
  </Step>

  <Step title="Create a new Discord bot">
    In the top right of the page, tap/click the "New Application" button.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/applications.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=d0bb795079b335a04e12f66d31b80eab" width="2560" height="1324" data-path="public/screenshots/proxy/applications.png" />

    Next, enter a name for your new app, and leave the selected team as "Personal" if shown.
    Then, tap/click the box to agree to the Developer Terms & Policies.
    And finally, tap/click "Create" in the bottom left.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/new-application.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=d5d5d5d860809e568bde96c48cf64e23" width="639" height="388" data-path="public/screenshots/proxy/new-application.png" />
  </Step>

  <Step title="Disable default installation links">
    Select the "Installation" page on the sidebar to switch to the installation settings page.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/general-installation-highlight.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=e4e8ca7ecd5111a99b5689efa63b7366" width="2560" height="1328" data-path="public/screenshots/proxy/general-installation-highlight.png" />

    Under "Installation Contexts", deselect "User Install", then select "None" in the "Install Link" select menu.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/installation.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=a29e49296fa74837b971c39de8c45580" width="2559" height="1329" data-path="public/screenshots/proxy/installation.png" />

    <Tip>Tap/click "Save Changes" at the bottom of the page after making changes.</Tip>
  </Step>

  <Step title="Configure publicity and intents">
    Select the "Bot" page on the sidebar to switch to the bot settings page.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/installation-bot-highlight.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=6170c5100dad81c54d1301b643b4b1a1" width="2560" height="1328" data-path="public/screenshots/proxy/installation-bot-highlight.png" />

    Toggle off "Public Bot", then scroll down and toggle on "Message Content Intent".

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/bot.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=23cdb9461ace5949ffdffef14323d34b" width="2560" height="1327" data-path="public/screenshots/proxy/bot.png" />

    <Tip>Tap/click "Save Changes" at the bottom of the page after making changes.</Tip>
  </Step>

  <Step title="Add your bot to your server">
    Select the "OAuth2" page on the sidebar to switch to the OAuth settings page.

    <img src="https://mintcdn.com/fyre/tZsdGg0UI2yaGyPC/public/screenshots/proxy/bot-oauth-highlight.png?fit=max&auto=format&n=tZsdGg0UI2yaGyPC&q=85&s=9cd47945fafc426086ece391a26bab1a" width="2560" height="1329" data-path="public/screenshots/proxy/bot-oauth-highlight.png" />

    Select the "bot" scope, then select the "Administrator" permission from the "Bot Permissions" panel that appears.

    <img src="https://mintcdn.com/fyre/tZsdGg0UI2yaGyPC/public/screenshots/proxy/oauth-generator.png?fit=max&auto=format&n=tZsdGg0UI2yaGyPC&q=85&s=6660fba7f6724bebeb2a255884065b85" width="2559" height="1328" data-path="public/screenshots/proxy/oauth-generator.png" />

    Next, scroll down and tap/click the copy button on the right of the Generated URL.

    <img src="https://mintcdn.com/fyre/tZsdGg0UI2yaGyPC/public/screenshots/proxy/oauth-copy-url.png?fit=max&auto=format&n=tZsdGg0UI2yaGyPC&q=85&s=f88296d2d42f60a1871a2af4d32d19ca" width="2559" height="1327" data-path="public/screenshots/proxy/oauth-copy-url.png" />

    Finally, paste the copied URL into a new tab and follow the instructions to add the bot to your server.
  </Step>

  <Step title="Reset your bot token">
    Select the "Bot" page on the sidebar to switch back to the bot settings page.

    <img src="https://mintcdn.com/fyre/tZsdGg0UI2yaGyPC/public/screenshots/proxy/oauth-bot-highlight.png?fit=max&auto=format&n=tZsdGg0UI2yaGyPC&q=85&s=10a78e5cc5e42776681e7af601b9c3ba" width="2559" height="1330" data-path="public/screenshots/proxy/oauth-bot-highlight.png" />

    Tap/click "Reset Token" and complete any authentication prompts that popup.

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/bot-reset-token.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=8eb8fd200bf8201c9e129af9fd619cd5" width="2560" height="1330" data-path="public/screenshots/proxy/bot-reset-token.png" />

    After resetting your token, tap/click "Copy".

    <img src="https://mintcdn.com/fyre/m6Ic1-z46kqulNd5/public/screenshots/proxy/bot-copy-token.png?fit=max&auto=format&n=m6Ic1-z46kqulNd5&q=85&s=65e64f163bd7b89240c6eee2513f2d0a" width="2560" height="1329" data-path="public/screenshots/proxy/bot-copy-token.png" />
  </Step>

  <Step title="Switch back to Discord for final setup">
    Then, switch back into Discord and use `/config proxy` in your server.
    Select "Custom Bot" as the mode, and paste your token into the `bot-token` field.

    Fyre will reply with further instructions to create a ticket in [Fyre Hub](https://discord.gg/SNxqD4ujTF) to complete your proxying setup.
  </Step>
</Steps>
