# Feedback workflow

## Create the endpoint

In Onboard, choose Product feedback. This enables feedback context and reporter
resolution follow-up for that endpoint.

## Submit a report

```ts
await fetch(
  "https://forms.devxgroup.io/api/v1/submit/product-feedback",
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.FORM_RELAY_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      email: "reporter@example.com",
      message: "Save button does nothing",
      _feedback: {
        pageUrl: "https://app.example.com/settings",
        appVersion: "1.4.0",
        environment: "production",
        browser: "Chrome 140",
        notifyReporter: true,
      },
    }),
  },
);
```

```json
{
  "ok": true,
  "lead_id": "lead_123",
  "feedback_status": "received"
}
```

The reserved `_feedback` object is stored separately from your application
payload. Supported fields are `pageUrl`, `appVersion`, `environment`,
`userId`, `screenshotUrl`, `browser`, `operatingSystem`, `locale`, and
`notifyReporter`.

## Connect the relay

1. Open Integrations and connect GitHub.
2. Choose repository access on GitHub.
3. Open Automations, choose the feedback endpoint, select Triage + issues, and choose the repository.
4. Choose an available schedule and enable the automation. Keep one enabled automation per endpoint.
5. Submit a new report after enabling the job. Triage + digest does not create issues.

The first canonical report creates a GitHub issue. Repeated reports become
comments on that issue when AI grouping is included. Free uses rules with a weekly
schedule; Indie allows daily and Pro allows as reports arrive. Scheduled jobs are
checked hourly, so a due daily or weekly job can wait until the next sweep.

Closing an issue as completed queues reporter email when the reporter opted in.
Closing as not planned does not mark reports resolved. Completion does not prove
a release is available. A still-broken response queues the issue to reopen.
Email is subject to the plan and shared provider caps.

In Leads, open a report and choose Copy coding brief for a reviewed handoff to
your coding assistant. The brief contains selected context and a verification
checklist. Review free-form text for private information before sharing it.
This does not start an agent, merge a pull request or deploy a fix.