Link parameters
Every app has a feedback link, on its Installation › Link tab in the TellsU dashboard:
https://go.tellsu.com/pk_yourpublickeyIt opens the hosted page on its own. Use it anywhere a link can go, including a button or widget of your own. Add query parameters to send details with the feedback, or to start the form on a feedback type or sentiment:
https://go.tellsu.com/pk_yourpublickey?v=2.4.1&t=bug&s=sadParameters
Section titled “Parameters”All of them are optional.
| Parameter | What it is | Values |
|---|---|---|
v |
Your app’s version | 2.4.1 |
t |
Feedback type to start on | bug, idea, question, praise |
s |
Sentiment to start on | happy, neutral, sad |
sc |
The part of your app it’s opened from, a short name, never an address | settings |
ch |
Release channel | stable, beta |
ed |
Your app’s edition | free, pro |
h |
Host: the software your app runs inside | Adobe Commerce |
hv |
Host’s version | 2.4.7 |
rt |
Runtime: what your app runs on | Node |
rv |
Runtime’s version | 22.11 |
e.<name> |
One of your own values (paid) | e.sync=on |
Values your app’s platform doesn’t keep are dropped: see What’s sent
in its quick start. e.<name> values are kept only for names you’ve allowed in your
app’s Form › Environment tab.
What’s detected
Section titled “What’s detected”The hosted page detects the browser and operating system from the browser it opens in. A link opened inside your app gets the browser your app runs in; a link in a README gets whichever browser the reader uses.
- Your user sees every value in the environment the page shows before sending.
- Values that look like an email address or a long token are masked, then every value is cut to 100 characters.
- The message is never in the link, and parameters are never shown as
the page’s text. A
torsthat isn’t one of the values above is ignored, as are parameters TellsU doesn’t know. - Keep the whole link under 2,000 characters.
- Links keep working. Every parameter here stays supported. If you rotate your app’s key, links with the old key open a page asking people to update your app.