Docs

Echoed helps you understand what to build next. Ask the right users a question inside your iOS app, connect your other feedback sources, and Echoed turns it all into ranked hypotheses backed by real quotes.

Requirements: iOS 16.0+, Swift 5.7+, Xcode 14+.

Add Echoed with Swift Package Manager. In Xcode, choose File → Add Package Dependencies and enter the repository URL:

https://github.com/tgrady18/EchoedSDK.git

Then initialize the SDK once at launch, before any other Echoed call:

import Echoed

@main
struct YourApp: App {
    init() {
        EchoedSDK.shared.initialize(
            apiKey: "YOUR_API_KEY",
            companyId: "YOUR_COMPANY_ID"
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

If the API key or Company ID is empty, initialize does nothing and logs an error. The optional baseURL parameter defaults to Echoed’s production host, so you can leave it off.

Tell Echoed who is using your app so feedback is tied to a real person instead of an anonymous device. Call setCustomer after login or signup. All parameters are optional.

// After login or signup
EchoedSDK.shared.setCustomer(
    id: "user_123",
    name: "Jane Smith",
    email: "jane@acme.com"
)

You can identify progressively. Set a name during onboarding, then add the id later:

// During onboarding, before an account exists
EchoedSDK.shared.setCustomer(name: "Jane")

// Later, after signup
EchoedSDK.shared.setCustomer(id: "user_123", email: "jane@acme.com")

Clear the identity on logout so later feedback is not attributed to the wrong person:

EchoedSDK.shared.resetCustomer()

resetCustomer clears only the customer identity. Internal session data and any user tags you set are preserved. If your app has no accounts, skip this entirely and feedback is grouped by device.

Questions appear at moments you choose, called anchors. Call hitAnchor with an anchor id where the moment happens, usually in onAppear:

struct CheckoutSuccessView: View {
    var body: some View {
        Text("Order confirmed")
            .onAppear {
                EchoedSDK.shared.hitAnchor("checkout_complete")
            }
    }
}

Create the matching message in the dashboard under Messages → Create Message. Set the same Anchor ID, write the question, and choose targeting and how often it can show. The anchor string in your code must match the message’s Anchor ID exactly.

A message is drawn over your app, so an active window scene must exist when the anchor fires. Responses send immediately and are not queued offline, so a failed network call is not retried.

Tags describe your users so you can target questions to the right people. Set a tag with a value and a type. Your dashboard targeting rules then match on these tags.

EchoedSDK.shared.setUserTag("plan", value: "pro", type: .string)
EchoedSDK.shared.setUserTag("projectCount", value: 12, type: .number)
EchoedSDK.shared.setUserTag("signupDate", value: Date(), type: .timestamp)
EchoedSDK.shared.setUserTag("isTeamAdmin", value: true, type: .boolean)

Remove a single tag, or clear all custom tags. Customer identity and internal tags are preserved:

EchoedSDK.shared.removeUserTag("plan")
EchoedSDK.shared.clearAllUserTags()

Keys that start with the reserved echoed_ prefix are rejected. Only tags you set exist, so set a tag before you target on it. To target free-plan users, for example, set plan to free, then add a targeting rule for plan is free on the message.

Echoed reads every response and groups it into insights. An insight is a lasting hypothesis about your users that updates as new feedback arrives, not a one-off label.

Actionable insights surface first; low-signal patterns stay out of the way behind a count. You can confirm, refute, watch, dismiss, or add a note, merge duplicates, and split an insight that is too broad.

When an insight needs proof, use Ask users to turn it into a targeted in-app question. Those answers flow back into the same pipeline as fresh evidence, and the confidence updates on its own.

In-app questions are one source. You can bring in more, and everything flows into the same insights.

Manage all of this under Sources in the dashboard.

Still stuck? Email hello@echoed-feedback.com.