Why add feedback to iOS apps?
A SwiftUI sheet posting to TellTide’s HTTP API gives you exactly that — structured bug reports and feature requests with the screen context attached.
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 URLSession
Encode the submission as JSON and send it with your publishable key:
func sendFeedback(type: String, comment: String) async throws {
var request = URLRequest(url: URL(string: "https://telltide.com/api/v1/public/feedback")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue(telltidePublishableKey, forHTTPHeaderField: "X-TellTide-Key")
request.setValue(UUID().uuidString, forHTTPHeaderField: "Idempotency-Key")
request.httpBody = try JSONEncoder().encode([
"type": type, // "feedback" | "review" | "bug" | "feature"
"comment": comment,
"page_url": "myapp://profile",
"page_title": "Profile",
])
_ = try await URLSession.shared.data(for: request)
}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
- Trigger the sheet from a shake gesture or a settings row — both are familiar iOS feedback patterns.
- Include the app version and iOS version in feedback_data for one-glance triage.
- The tt_pub_ key is intentionally public and restricted to feedback submission.
Common questions
Does this replace App Store reviews?
It complements them. Catch bugs and requests privately in TellTide first; then prompt your happiest users for the public App Store review. Public ratings improve when problems have a private exit.
Is there a native TellTide SDK for iOS?
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.