Docs

Getting Started

Create an app, customize the widget, embed the script, and receive your first submission.

1. Create an app

  1. Sign in and open Apps.
  2. Click New app (or use Create app on the dashboard).
  3. Fill in:
    • App name — display name in TellTide
    • Platform — Mobile App, Website, or Desktop App (label only)
    • Description — short summary
    • App link — the public URL where the widget will run (e.g. https://www.yoursite.com)

On success you receive:

  • App ID — 8-character identifier used in your embed snippet
  • Publishable key — submission-only and configured automatically by the widget
  • Private server key — shown once; copy it only for a trusted backend integration

2. Customize the widget

  1. From Apps, open Manage Widget for your app.
  2. Configure:
    • Categories — review, general feedback, bug, feature request (at least one required)
    • Appearance — colors, launcher label, panel title, position, fonts
    • Behavior — triggers and visibility options
  3. Click Save.
  4. Use Copy embed code to get your install snippet.

3. Embed the widget

Paste this before </body> on the site that matches your App link:

<script
  src="https://telltide.com/src/widgets/widget.js"
  data-app-id="YOUR_APP_ID"
></script>

Replace YOUR_APP_ID with the ID from Apps. The snippet in Manage Widget already includes the correct App ID.

4. Verify a submission

  1. Open your site and click the TellTide launcher.
  2. Submit test feedback.
  3. Open Feedbacks — the row should appear within seconds.
  4. Click a row to open the detail view and change status.

Local development

Testing on localhost works without changing App link. For production, the page hostname must match App link. www and the apex host are treated as the same site.

Next steps