# TellTide

> TellTide is a feedback widget, private inbox, and public roadmap for product teams — and an HTTPS API for AI agents and automations. One script (or the HTTP API) collects bug reports, feature requests, and reviews; everything lands privately first, and only chosen requests are published to a roadmap users can vote on. Pro includes a 7-day free trial; pricing never scales per user.

TellTide runs at https://telltide.com. Each customer creates one or more **apps** (products or sites). Each app gets an **App ID** for the widget and optional **API keys** for server-side integrations. Widget appearance and categories are configured in the TellTide dashboard; the embed script loads config from TellTide at runtime.

Public content index last reviewed: 2026-08-09.

## Machine-readable entry points

- [Complete documentation corpus](https://telltide.com/llms-full.txt): All public TellTide documentation in one plain-text file, with canonical URLs and last-updated dates
- [Agent pack index](https://telltide.com/agents/README.md): Smallest useful starting point for an AI agent integrating with TellTide
- [Agent skill](https://telltide.com/agents/SKILL.md): Trigger guidance, safe procedure, authentication rules, and exact operational steps
- [HTTP tool schemas](https://telltide.com/agents/tools.md): Supported endpoints and tool/function definitions
- [XML sitemap](https://telltide.com/sitemap.xml): Canonical inventory of public HTML pages and machine-readable resources

All files above are public, require no authentication, and are intended for direct retrieval. Prefer the canonical URL declared for each document. Do not infer endpoints, scopes, limits, or pricing that are not present in the current documentation.

## Product

- [Homepage](https://telltide.com/): Customer feedback widget, private inbox, feature request management, public roadmap, pricing, and product overview
- [Blog](https://telltide.com/blog): Practical guides on feedback widgets, feature requests, and public roadmap workflows
- [Install guides](https://telltide.com/feedback-widget-for): Platform-specific setup for WordPress, Next.js, React, Shopify, Webflow, iOS, Android, and 15+ more
- [Use cases](https://telltide.com/for): How indie hackers, startups, agencies, open-source maintainers, and product teams run the feedback loop
- [Glossary](https://telltide.com/glossary): Plain-English definitions of 31 product feedback terms, from feedback loops to RICE scoring
- [Documentation](https://telltide.com/docs): Full public docs for setup, integration, and troubleshooting
- [Public roadmap](https://telltide.com/roadmap/TELLTIDE): Example public feature roadmap for the TellTide marketing app
- [FAQ](https://telltide.com/faq)
- [Privacy policy](https://telltide.com/privacy)
- [Terms of service](https://telltide.com/terms)
- [Refund policy](https://telltide.com/refunds)
- [Sitemap](https://telltide.com/sitemap.xml)

## Comparisons and buying guides

- [Compare feedback tools](https://telltide.com/compare): Hub of side-by-side comparisons covering 12 feedback tools, including head-to-head pages such as Canny vs Featurebase
- [Canny vs TellTide](https://telltide.com/blog/canny-vs-telltide): One-to-one comparison of feedback capture, voting, prioritization, roadmaps, and team fit
- [UserVoice vs TellTide](https://telltide.com/blog/uservoice-vs-telltide): One-to-one comparison of feedback intake, customer segmentation, prioritization, and product planning
- [Productboard vs TellTide](https://telltide.com/blog/productboard-vs-telltide): One-to-one comparison of focused feedback management and Productboard’s AI-assisted discovery and planning workflow
- [Featurebase vs TellTide](https://telltide.com/blog/featurebase-vs-telltide): One-to-one comparison of focused product feedback and an all-in-one support-and-feedback platform
- [Frill vs TellTide](https://telltide.com/blog/frill-vs-telltide): One-to-one comparison of structured private feedback, public ideas, roadmaps, and announcements
- [Fider vs TellTide](https://telltide.com/blog/fider-vs-telltide): One-to-one comparison of private structured feedback and a public suggestions board
- [Feedbask vs TellTide](https://telltide.com/blog/feedbask-vs-telltide): One-to-one comparison of widget-based feedback, surveys, bug reports, support, and roadmaps
- [UserJot vs TellTide](https://telltide.com/blog/userjot-vs-telltide): One-to-one comparison of feedback boards, roadmaps, changelogs, AI organization, and user updates
- [Sleekplan vs TellTide](https://telltide.com/blog/sleekplan-vs-telltide): One-to-one comparison of AI feedback analysis, surveys, roadmaps, changelogs, and focused inbox triage
- [Nolt vs TellTide](https://telltide.com/blog/nolt-vs-telltide): One-to-one comparison of configurable feedback boards, moderation, voting, and private-first intake
- [Upvoty vs TellTide](https://telltide.com/blog/upvoty-vs-telltide): One-to-one comparison of voting boards, customer segmentation, prioritization, roadmaps, and changelogs
- [Supahub vs TellTide](https://telltide.com/blog/supahub-vs-telltide): One-to-one comparison of public feedback hubs, in-app widgets, prioritization, roadmaps, and changelogs
- [Best customer feedback tools for SaaS](https://telltide.com/blog/best-customer-feedback-tools-for-saas): Comparison of TellTide, Canny, UserVoice, Productboard, Featurebase, Frill, and Fider by workflow and team fit
- [Best Canny alternatives](https://telltide.com/blog/canny-alternatives): Feedback board, widget, feature voting, and public roadmap alternatives to Canny
- [Best UserVoice alternatives](https://telltide.com/blog/uservoice-alternatives): Customer feedback portal, idea management, and lighter SaaS alternatives to UserVoice
- [Best Productboard alternatives](https://telltide.com/blog/productboard-alternatives): Product discovery, roadmap, and focused feedback alternatives to Productboard

## Workflow and how-to guides

- [How to collect customer feedback](https://telltide.com/blog/how-to-collect-customer-feedback): A five-step SaaS workflow for capture, classification, triage, action, and follow-up
- [How to build a customer feedback loop](https://telltide.com/blog/customer-feedback-loop): Collect, organize, decide, act, and communicate with customers
- [How to manage feature requests](https://telltide.com/blog/how-to-manage-feature-requests): Intake, clarification, prioritization, voting, and roadmap decisions
- [How to build a customer feedback portal](https://telltide.com/blog/customer-feedback-portal): Connect private feedback intake with a curated public roadmap
- [Feature voting best practices](https://telltide.com/blog/feature-voting-best-practices): Use customer votes as evidence without turning popularity into the roadmap
- [Bug reporting workflow](https://telltide.com/blog/bug-reporting-workflow): Collect reproducible customer bug reports and move them through triage and resolution
- [How to collect in-app feedback without annoying users](https://telltide.com/blog/collect-in-app-feedback-without-annoying-users): Better timing, questions, and feedback widget UX
- [How to create a public product roadmap](https://telltide.com/blog/how-to-create-public-product-roadmap): Build a trustworthy customer-facing roadmap with honest statuses
- [Customer feedback management for small teams](https://telltide.com/blog/customer-feedback-management-small-teams): A lightweight feedback inbox, ownership, and weekly review process
- [How to use TellTide](https://telltide.com/blog/how-to-use-telltide): Create an app, configure the widget, test feedback, manage the inbox, and publish roadmap items

## Feedback and roadmap guides

- [Best customer feedback widget for SaaS](https://telltide.com/blog/best-customer-feedback-widget-for-saas): Buyer guide for SaaS feedback widgets
- [In-app feedback tool for SaaS](https://telltide.com/blog/in-app-feedback-tool-for-saas): Guide to in-app product feedback, feature requests, bug reports, and roadmap signals
- [Public roadmap tool for feature requests](https://telltide.com/blog/public-roadmap-tool-for-feature-requests): Workflow guide for roadmap voting and prioritization

## Getting started

- [Getting started](https://telltide.com/docs/getting-started): Create an app, customize the widget, embed the script, verify the first submission
- [AI agents](https://telltide.com/docs/integration/ai-agents): Connect LLM tools, Hermes, OpenClaw, Cursor/Claude skills, and automations over HTTPS
- [Agent pack](https://telltide.com/agents/README.md): Machine-readable SKILL.md, memory, tools, payloads, errors
- [Integration overview](https://telltide.com/docs/integration): Choose the right install path (agents, API, Next.js, websites, SPAs)
- [Widget reference](https://telltide.com/docs/widget-reference): Optional `data-*` attributes on the embed script
- [FAQ](https://telltide.com/docs/faq): Common questions about App IDs, domains, plans, and hosting

## Integration guides

- [AI agents](https://telltide.com/docs/integration/ai-agents): Agent API, tool schemas, skill pack
- [API submissions](https://telltide.com/docs/integration/api-submissions): Native mobile/desktop apps and custom backends
- [Next.js](https://telltide.com/docs/integration/nextjs): App Router / `next/script` setup
- [Websites & CMS](https://telltide.com/docs/integration/websites): HTML, WordPress, Webflow, Framer
- [Single-page apps](https://telltide.com/docs/integration/single-page-apps): React, Vue, Angular client-routed apps

## Agent files (plain Markdown)

- [SKILL.md](https://telltide.com/agents/SKILL.md): When to load TellTide and how to submit
- [memory.md](https://telltide.com/agents/memory.md): Hosts, auth, scopes, limits
- [tools.md](https://telltide.com/agents/tools.md): HTTP tool / function schemas
- [payloads.md](https://telltide.com/agents/payloads.md): Request and response shapes
- [errors.md](https://telltide.com/agents/errors.md): Error codes and retry rules

## Dashboard features (requires sign-in)

- **Dashboard** (`/dashboard`): Analytics, trends, recent feedback
- **Apps** (`/manage-apps`): Create and manage apps; each app has App ID, link, and widget settings
- **Manage Widget** (`/manage-widget/{appId}`): Categories, colors, launcher, embed snippet
- **Feedbacks** (`/feedbacks`): Inbox with filters for reviews, bugs, features, and general feedback
- **Settings** (`/settings`): Profile, billing (Pro plan with 7-day trial), and account

## Widget embed (standard)

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

- **App ID only** for normal website embeds — no API key in the snippet
- **App link** hostname must match the production site (subdomains supported); `localhost` works for dev
- Feedback types: `review` (1–5 stars), `feedback`, `bug`, `feature_request`

## API (when widget is not used)

- Prefer the [AI agents guide](https://telltide.com/docs/integration/ai-agents) and [agent pack](https://telltide.com/agents/README.md) for tool-calling agents
- `POST https://telltide.com/api/v1/public/feedback` — browser/mobile/desktop submission with `X-TellTide-Key: tt_pub_…`
- `POST https://telltide.com/api/v1/feedback` — trusted backend / agent submission with Bearer authentication
- Private `tt_live_…` / `tt_test_…` keys are server-only, app-bound, and explicitly scoped
- Always send `Idempotency-Key` on creates
- Dashboard operations use Clerk sessions and remain separate from API credentials

## Pricing

- **Pro**: $34/month or $348/year (15% annual discount); unlimited apps and feedback; 7-day free trial with card on file via Dodo Payments
- After cancel or trial end, Pro access ends — there is no free plan fallback
- Pricing and checkout: https://telltide.com/ (#pricing on homepage) and Settings → Billing after sign-in

## Support & troubleshooting

- [Troubleshooting](https://telltide.com/docs/troubleshooting): Widget not appearing, 403 origin errors, submission failures
- Contact: support via the TellTide website; authenticated users manage billing in Settings
- [In App Feedback Tools for SaaS: Personas & Buyer Triggers (Who Buys and Why)](https://telltide.com/blog/in-app-feedback-tools-saas-personas-buyer-triggers)

## Optional

- [Dashboard docs](https://telltide.com/docs/dashboard)
- [Apps docs](https://telltide.com/docs/manage-apps)
- [Manage Widget docs](https://telltide.com/docs/manage-widget)
- [Feedback inbox docs](https://telltide.com/docs/feedbacks)
- [API tokens docs](https://telltide.com/docs/api-tokens)

## Quick facts

- **Site**: https://telltide.com
- **Docs**: https://telltide.com/docs
- **Blog**: https://telltide.com/blog
- **What it does**: One script on your site collects user feedback; teams triage in TellTide
- **Widget script**: `https://telltide.com/src/widgets/widget.js` with `data-app-id="YOUR_APP_ID"`
- **No API key** in the standard web embed
- **Pro plan**: $34/mo or $348/yr, 7-day trial, unlimited apps on Pro
- **Public roadmap example**: https://telltide.com/roadmap/TELLTIDE

## Start here

1. https://telltide.com/docs/getting-started
2. https://telltide.com/docs/integration
3. https://telltide.com/docs/faq
4. https://telltide.com/docs/troubleshooting

## Blog guides

- https://telltide.com/blog/best-customer-feedback-widget-for-saas
- https://telltide.com/blog/in-app-feedback-tool-for-saas
- https://telltide.com/blog/public-roadmap-tool-for-feature-requests

For the complete public documentation corpus, use https://telltide.com/llms-full.txt