Collect user feedback in Flutter apps

Why add feedback to Flutter apps?

The whole integration is one HTTP call; everything else is a widget (the Flutter kind) you already know how to build.

Step 1: Create a TellTide app and copy its publishable key

Sign in to TellTide, open Apps, and create an app with the Mobile App or Desktop App platform label. Open API credentials and copy the tt_pub_ publishable key. It is intentionally visible and can only submit feedback. Never put a tt_live_ or tt_test_ private key in a client application.

Step 2: Post feedback with the http package

Send the submission as JSON with the submission-only publishable key:

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> sendFeedback(String type, String comment) async {
  await http.post(
    Uri.parse('https://telltide.com/api/v1/public/feedback'),
    headers: {
      'Content-Type': 'application/json',
      'X-TellTide-Key': telltidePublishableKey,
      'Idempotency-Key': createSubmissionId(),
    },
    body: jsonEncode({
      'type': type, // 'feedback' | 'review' | 'bug' | 'feature'
      'comment': comment,
      'page_url': 'myapp://settings',
      'page_title': 'Settings',
    }),
  );
}

Step 3: Verify the submission in your inbox

Send a test request and check the response for a feedbackId. The submission appears in your TellTide inbox immediately, tagged with the page_url and page_title context you sent — use those fields for the screen name, route, or deep link the user was on.

Good to know

• A tt_pub_ key is public by design. Build-time configuration is convenient but is not a secret store.
• Reviews accept a rating field (1–5); bug reports can carry structured detail in feedback_data.
• One TellTide app can serve iOS and Android builds together, or split them for per-platform triage.