Why add feedback to React Native apps?
TellTide’s web widget does not run inside React Native, and it does not need to: your own screen posts JSON to one endpoint, and submissions land in the same inbox as your web feedback.
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 fetch
Build a small feedback screen (type picker, comment box, optional email) and submit it to the feedback endpoint:
await fetch('https://telltide.com/api/v1/public/feedback', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-TellTide-Key': TELLTIDE_PUBLISHABLE_KEY,
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
type: 'bug', // 'feedback' | 'review' | 'feature'
name: user.name,
email: user.email,
comment: text,
page_url: 'myapp://checkout',
page_title: 'Checkout',
}),
});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
- The tt_pub_ key is designed for app binaries and has submission-only permission. Use a private key only from a trusted backend.
- Use page_url for the deep link or route name — it becomes the context your team sees during triage.
- The type field maps to inbox categories: feedback, review (with a 1–5 rating), bug, and feature.
Common questions
Can I show the web widget in a WebView instead?
A native form posting to the API is the better experience — no WebView weight, works offline-queued if you add retry, and matches your app’s design. The API accepts the same fields the widget sends.
Is there a native TellTide SDK for React Native?
No SDK is required — the API is one JSON POST with two IDs, small enough that a wrapper library would be more code than the integration itself. Your HTTP client of choice already does the job.
Is the feedback public?
No. Every submission lands in your private TellTide inbox first. You choose which feature requests to publish to your public roadmap, where users can vote and comment.
How much does TellTide cost?
Pro includes the widget, private inbox, API, and public roadmap, with a 7-day free trial. Pricing never scales with how many users you have.
