Collecting Feedback

Three ways to collect feedback from your users — the embedded widget, the REST API, or manual submission in the dashboard.

You can collect feedback in three ways: the feedback widget embedded on your site, the REST API for programmatic submission, or manual entry from the dashboard.

The feedback widget is a small button that floats on your site. When clicked, it opens a form where users can submit feedback without leaving the page.

Getting the embed code

Go to Feedback → Settings in your dashboard.

Copy the embed snippet from the Widget tab.

Paste it into your site's HTML before the closing </body> tag.

<!-- Paste before </body> -->
<script
  src="https://cdn.futurebase.ai/feedback.js"
  data-project-id="YOUR_PROJECT_ID"
  async
></script>

The actual embed snippet in your dashboard contains your real agent ID. Use the snippet from the dashboard, not this placeholder.

Framework-specific setup

Use Next.js's Script component to load the widget after the page is interactive:

import Script from "next/script";

export default function Layout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script
          src="https://cdn.futurebase.ai/feedback.js"
          data-project-id="YOUR_PROJECT_ID"
          strategy="lazyOnload"
        />
      </body>
    </html>
  );
}

Add the snippet before the closing </body> tag in your HTML template:

<body>
  <!-- your content -->
  <script
    src="https://cdn.futurebase.ai/feedback.js"
    data-project-id="YOUR_PROJECT_ID"
    async
  ></script>
</body>

Install the Insert Headers and Footers plugin, then paste the snippet in the Footer Scripts field. Save and verify on your live site.

You can configure the widget appearance and behavior from Feedback → Settings → Widget:

Option	Description
Button label	Text shown on the floating button (default: "Feedback")
Button position	Bottom-left or bottom-right
Accent color	Matches your brand color
Prompt text	Placeholder inside the feedback textarea
Categories	Optional dropdown to let users tag their feedback (Bug, Feature, Other)

Option 2: REST API

Use the REST API to submit feedback programmatically — for example, from an in-app NPS survey, a post-interaction prompt, or a backend system.

Authentication

All API requests require an API key. Get yours from Settings → API Keys.

Authorization: Bearer YOUR_API_KEY

Submit feedback

POST https://api.futurebase.ai/v1/feedback
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "content": "It would be great if I could export conversations to CSV.",
  "category": "feature",
  "userEmail": "user@example.com",
  "userName": "Jane Smith",
  "metadata": {
    "plan": "pro",
    "source": "in-app-survey"
  }
}

Request fields:

Field	Type	Required	Description
`content`	string	Yes	The feedback text (max 5,000 chars)
`category`	string	No	`"bug"`, `"feature"`, `"other"`
`userEmail`	string	No	Email of the user submitting feedback
`userName`	string	No	Display name of the user
`metadata`	object	No	Arbitrary key/value pairs (plan, version, page, etc.)

Response:

{
  "id": "fb_01J9XXXXXX",
  "status": "received",
  "clustered": false
}

Newly submitted feedback is queued for AI clustering. The clustered field will be true once the AI has processed and assigned it to a cluster (usually within a few minutes).

Option 3: Manual submission

You can add feedback directly from the dashboard — useful for logging feedback received via email, sales calls, or support conversations.

Go to Feedback → All Feedback.

Click Add Feedback.

Enter the feedback text, optionally set a category and user info, then click Save.

Best practices

Capture context — pass metadata like the current page, plan tier, or app version. This helps with filtering and clustering.
Don't require a login — anonymous feedback is better than no feedback. Collect email optionally.
Prompt at the right moment — post-interaction (after a support chat resolves) or post-onboarding are high-signal moments.
Keep the form short — a single textarea converts better than a multi-field form.