Feedback

The Feedback module gives your team a central place to collect, review, and organize reports from customers and end users. It turns individual reports into grouped product signals that can inform requirements, planning, and implementation.

• Feedback is an individual customer or end-user report, including its submitter, written content, and attachments.
• Themes group related patterns so teams can identify repeated needs, requests, or pain points.

Use Feedback to keep customer signals connected to product planning instead of scattering them across notes, isolated tickets, or unsupported roadmap guesses.

Reporting feedback

Use the Feedback Integration API to submit reports from your application or internal tooling. Create a Feedback Integration API key from the module's Connect tab, then call:

POST /v2/reporting-api/feedback
X-API-Key: sf-rpt-...
Content-Type: application/json

{
  "end_user_email": "customer@example.com",
  "content": "Feedback text in Markdown",
  "attachments": [
    {
      "file_name": "screenshot.png",
      "file_key": "uploaded-file-key",
      "file_size": 123456,
      "mime_type": "image/png"
    }
  ]
}

end_user_email and content are required. attachments is optional. Do not send a title; Software Factory manages feedback titles internally.

The endpoint returns the created feedback number:

{
  "feedback_number": 123
}

Migrating from Validator

The legacy Validator endpoint is deprecated and is scheduled for retirement on August 1, 2026:

POST /v1/integration/validator/feedback
X-App-Key: sf-int-...

If your integration still uses it:

1. Change the endpoint to POST /v2/reporting-api/feedback.
2. Replace the Validator API key with a Feedback Integration API key.
3. Send the feedback text in the content field.
4. Stop sending client-provided titles.

Existing Validator feedback remains available in the Feedback module after migration.

Reviewing feedback

New reports appear in the Feedback Inbox as FB-N items. Search, filter, group, and sort the inbox to find unprocessed reports.

Open an item to review the full submission, attachments, comments, activity, and linked theme evidence. After the team understands the report and connects it to the correct theme, mark it as processed.

Themes

Themes turn related reports into product signals. A theme can include:

• Title, type, priority, and status
• Feature area and assignee
• A brief and quote evidence
• Linked Work Orders

Quotes are exact passages from feedback. They connect a theme to users' words and keep planning grounded in evidence. Link themes to the Work Orders that address the underlying issue or request.

Feedback triage automation

Enable feedback triage automation to run whenever a new report is submitted. Software Factory then starts the Feedback Agent's triage workflow automatically.

The workflow:

1. Reviews the feedback.
2. Matches it to an existing theme or creates a new theme.
3. Extracts representative quote evidence.
4. Updates the theme brief when needed.
5. Marks the feedback as processed when triage is complete.

Use automation when you want incoming feedback organized continuously instead of waiting for manual inbox review.

Continue with Organization Management.