Docs
How to use Convo — from your first workspace to wiring feedback into your own product and handing triage to an AI assistant. Search the docs from the sidebar, or start with a guide below.
Using Convo
- Getting startedSign in, create a workspace and a product, and share the page that collects your first feedback.
- The public pageWhat your users see at /{workspace}/{KEY}: the capture box, the Board, Roadmap and Changelog, item pages, +1s and replies, and how someone chooses to be known.
- Workspaces, members and settingsRoles and invites, products and their visibility, the product settings page, white-label branding, and what the owner alone can do.
- Triage the feedThe maker view of a product: the feed, the five statuses, keyboard and swipe triage, merging duplicates, and tags.
- Keyboard shortcutsEvery shortcut on the feed and the item page, generated from the same list the ? overlay shows.
- People, not votesWhy the person is Convo's unit of record: what a person record holds, the three identity tiers, what you can see, and what stays private.
- Ship, notify, changelogWhat happens when an item ships: the changelog entry that writes itself, the notify prompt, who gets mail, and how to see what you still owe.
Wire Convo into your product
- Wire Convo into your productFour ways to put Convo in front of your users — a link, the one-line widget, your own capture UI, or the API — and how the loop closes back out to the rest of your stack. With the setup Can uses.
- Embed the capture boxOne script tag drops the “Tell us anything” box into your app: the attributes, what it renders, how identity works, CSP, and its limits.
- Build your own capture UISkip the script and POST to the capture endpoint from your own component — the contract, a fingerprint recipe, the honeypot, and drop-in samples in curl, plain JavaScript and React. This is how Can does it.
- REST APIThe public API at api.convo.randomfact.com: every operation an agent or script can call, how to authenticate (API tokens, OAuth 2.1, Firebase), addressing, and worked curl examples.
- Outbound webhooksGet a signed POST when feedback arrives, changes status, or gets a reply: the events, the payload, signature verification with a working receiver, delivery semantics, and a recipe.
AI and MCP
- Connect your AI assistantPoint Claude, ChatGPT or any MCP client at mcp.convo.randomfact.com and let it triage, summarize and draft against your feedback — setup, what it can do, what to ask, and the one thing it always asks you first.
- Your users' AI assistantsA two-tool public scope lets an end user's assistant file feedback or read your roadmap at the moment of friction — what it is, how a client asks for it, and how to tell your users.