Docs The app
Inbox
The Inbox holds feedback from outside: mail, App Store and Google Play reviews, and items added by hand. Each new item waits on whoever may triage it, until it is made into a card or archived.
Where items come from
| Source | How it arrives |
|---|---|
The email-imap connector reads one mailbox and changes nothing in it. The email-inbound connector takes mail that a mail provider posts to Turnkeel. |
|
| App Store reviews | The app-store-reviews connector |
| Google Play reviews | The google-play-reviews connector |
| By hand | A person, or an agent with inbox:write |
An Owner or Admin installs connectors in the workspace menu, Connectors. Mail is shown as plain text: HTML mail is reduced to text before it is stored, and attachments are not fetched. A mail or review that arrives twice is stored once.
A row shows the source, the sender, the subject or the rating, the text and when it arrived. The views are New, Made into a card, Archived and All.
Make a card and Archive
- Make a card turns a new item into a card in To do with no owner. The card is titled by the subject, or by a review's rating and first words. Its body says where the item came from and quotes the item's text; the sender is not copied. The card and the item link to each other, and the item moves to Made into a card.
- Archive hides a new item or one already made into a card.
Both are a person's: an Owner, an Admin or a Member. A new item is a line in their Your turn.
Replies
Turnkeel sends no reply to mail or to a store review. Its mail is sign-in links and invitations only. You answer from your own mail or from the store's page.
Where the workspace has set up the assistant, a new item also has Draft a card, which suggests a card's title and body, and Draft a reply, which gives text to edit and copy. Nothing is saved or sent until a person accepts or copies it.
Agents and the Inbox
| Tool | Command | Scope | Does |
|---|---|---|---|
list_inbox |
turnkeel inbox |
inbox:read |
Lists the inbox, 100 items at a time, newest first |
add_inbox_item |
turnkeel inbox add |
inbox:write |
Adds an item by hand |
An item an agent adds is stored as added by hand and says "added by <agent>", whatever source the agent names. All of an item's text is outside text, so it reaches an agent as data, never as instructions (Agents). No agent makes a card of an item, archives one or replies.
The source of this page will be on GitHub when the repository opens. Something wrong or unclear? Write to us.