# Discord (capture feedback with a right-click)

Install the Usero Discord app on your server and anyone on the server can send any message to your Usero inbox with one action:
right-click the message, open **Apps**, and pick **Send to Usero** or **Send to Usero and draft PR**. The message text, author,
and timestamp land in your inbox as a feedback item. No bot reads your channels and no message-content access is requested.

## What it does

- **Context-menu capture.** Right-click (or long-press on mobile) any message, pick **Apps**, and choose a command. One action per
  message, explicit every time. Nothing is captured passively.
- **Two commands, same capture model as Slack.** "Send to Usero" captures the message and stops. "Send to Usero and draft PR"
  captures and, if a GitHub repo is connected, opens an AI-authored GitHub pull request with a first pass at the fix. You review
  the PR and merge it.
- **No passive channel mirroring.** There is no always-on connection, no webhook watching your channels, and no MESSAGE_CONTENT
  privileged intent. Usero receives a message only when a team member explicitly sends it.
- **Works in any channel.** Once the app is installed on the server, the commands are available in every channel without any
  per-channel setup.

## Prerequisites

- A Usero account and a project.
- Permission to install an app on your Discord server (or a server admin who can approve it).
- For the "Send to Usero and draft PR" command to draft a PR, a [connected GitHub repository](/docs/integrations/github). Without
  one, the command still captures the message; it skips the PR.

## Connect Discord

1. Open your project, then go to **Integrations** (the URL is `usero.io/YOUR_CLIENT_ID/integrations`). To open your own
   integrations page, [go here](/integrations).
2. Find the **Discord** card and click **Connect Discord**.
3. Discord opens its authorization screen. Choose which server to add the app to and approve the requested permissions. Usero
   requests only the minimum scopes to register the context-menu commands: no message-reading intent is included.
4. Discord sends you back to Usero. The integration is now active on the server you selected, and the Discord card on the
   integrations page shows as connected.

Each Usero project connects to one Discord server at a time. To use the same server across multiple projects, install the app
separately for each project.

## The two commands

Right-click any message on the connected server, open **Apps**, and pick one:

- **Send to Usero.** Captures the message as a feedback item and stops. Use this for feedback worth keeping but not yet ready to
  become a code change, or when you want to cluster it with similar reports first. You can open a PR from it later in the
  dashboard.
- **Send to Usero and draft PR.** Captures the message and, if your repo is connected, opens a GitHub pull request with a first
  pass at the fix. The PR body quotes the Discord message and links back to the feedback item. You review the diff and merge
  through your own branch protection. Usero never merges for you.

Capture is idempotent: sending the same message twice does not create a second feedback item.

## Where captured messages land

Each captured message becomes a feedback item in your project inbox, tagged with `discord` as the source. The item carries the
message text, the author's display name (Discord does not expose message-author email addresses, so the email field is blank, same
as Slack), and the capture timestamp. It clusters alongside widget, Slack, email, and app-review feedback in the same inbox.

## Troubleshooting

**The Apps menu doesn't show Usero commands.** The app may not be installed on this server, or the install is bound to a different
project. Re-run **Connect Discord** from the integrations page of the right project and make sure you pick the correct server on
Discord's authorization screen.

**"Send to Usero and draft PR" captured the message but no PR opened.** A PR needs a connected GitHub repo. Open the GitHub
section in your project and connect a repository (see the [GitHub integration docs](/docs/integrations/github)). The command still
captures without a repo; it just skips the PR.

**A message captured but the PR draft failed or said the workspace is out of AI pull requests.** PR creation is metered by plan.
The message is still in your inbox. You can upgrade in Usero and kick off the PR from the dashboard, or create the PR next period.
Capturing feedback is not metered, only drafting the PR is.

**The Discord card shows as connected but commands aren't showing up.** Discord can take a few minutes to propagate newly
registered app commands to all clients. Wait a minute, then close and reopen Discord. If commands still don't appear, re-run the
install flow.

**Removing Usero from Discord.** Uninstalling the app from your Discord server stops the commands immediately. The feedback items
already in your inbox remain, but new captures from that server stop.

## Next

- [Integrations overview](/docs/integrations)
- [GitHub integration (so "Send to Usero and draft PR" can open pull requests)](/docs/integrations/github)
- [Find your clientId](/docs/find-your-client-id)