Connect
Connected apps
The workspace owner connects apps like Gmail, Notion and Klaviyo on the Apps page. Piste uses their read tools freely and asks before it sends or changes anything.
Connected apps are the tools you run the business in, such as Gmail, Notion or Klaviyo. The workspace owner connects each one on the Apps page (Apps, in the links at the foot of the sidebar), and Piste can then use it in the owner's conversations and automations. Piste uses an app's read-only tools without asking, and asks before anything that would send or change something.
Which apps can I connect?
The Apps page suggests six apps to start with. To find any other, type at least three letters into "Search apps".
| App | What the suggestion says |
|---|---|
| Gmail | Read and draft replies to customer and supplier email. |
| Google Drive | Find line sheets, invoices and briefs. |
| Notion | Read and update your launch plans and SOPs. |
| Google Sheets | Keep the reorder sheet in step with Shopify. |
| Klaviyo | See how each campaign sold, and draft the next one. |
| Gorgias | Summarise support tickets by product. |
Each app is one sign-in per workspace. Sign-ins go through Composio, the service that holds them.
How do I connect an app?
Open the Apps page
Press Apps in the links at the foot of the sidebar. Under "Add an app", find the app in the list or search for it.
Press Connect
Press Connect beside the app. Piste opens the app's sign-in page.
Sign in and allow access
Sign in to the app and allow access. You come back to the Apps page, which says the app "is connected. Ask the agent to use it." The app now appears under Connected.
You can also ask Piste in a conversation, for example "connect Gmail". Piste asks you to sign in and carries on once you have: in the web app, a card says the app "needs you to sign in", with a Sign in to <app> button. The app's tools are available from your next message.
What can Piste do in a connected app?
It depends on whether you're in the conversation.
| Where | Read-only tools | Anything that sends or changes something |
|---|---|---|
| Your conversation with Piste | Run without asking | Waits for your approval in the conversation |
| An automation run | Run | Refused: "an automation run can't send or change anything there, since nobody is there to approve it" |
Composio marks which of an app's tools are read-only. Approvals and refusals are recorded in the decision log. An app's read-only calls aren't.
What can Piste propose in an app?
An automation run can't act in an app, but Piste can propose an action on a card, from a short list that Piste keeps in its code. Today the list has two actions: creating a Gmail draft, and deleting that draft again. Nothing on the list sends anything.
The one use so far is the supplier reorder draft: a reorder email to your supplier for one product variant and a quantity, as a draft in your Gmail. Piste can propose it in your automations' runs, or when you ask in your own Slack conversation with Piste, and only while Gmail is connected. Piste writes the whole email from a fixed template and your store's facts (the product, the variant, its SKU, the quantity and your store's name), asking the supplier to confirm the price and when it could ship. It addresses the email only to the supplier address you gave Piste.
| On the card | Detail |
|---|---|
| Title | "Draft a reorder email to your supplier", with the item and quantity |
| What it says | "In your Gmail drafts. Nothing is sent.", then the email in full |
| Buttons | Create the draft and Leave it, then Delete the draft once it's created |
| Where | Slack only: under an automation run's post, or in your Slack conversation with Piste. Piste can't propose one in the web app or over iMessage. |
| Who may press | The workspace owner only, since it's the owner's Gmail. A teammate's press asks the owner in the card's thread. |
| Out of date | After 7 days without a decision |
| Waiting at once | At most 10 |
To give Piste your supplier's address, tell it in a conversation, for example "our supplier's email is orders@example.com", and approve saving it. Only the owner can, and never from an automation run. Without an address, the card asks for one and has no button. If you change or forget the address after a card was raised, pressing Create the draft on that card creates nothing: ask for the draft again.
The Gmail draft hasn't yet been run against a real mailbox.
Who can use connected apps?
Only the workspace owner connects, reconnects or disconnects an app, on the Apps page or by asking Piste.
Only the owner's own conversations and automations can use the apps, because each app is signed in with the owner's account. A teammate talking to Piste in Slack, or any light member, can't read your mailbox or drive through Piste.
How do I reconnect or disconnect an app?
An app whose sign-in expired shows "Needs reconnecting". Press Reconnect beside it and sign in again. An app shows "Sign-in not finished" when its sign-in didn't complete.
To remove an app, press Disconnect beside it and confirm. Piste loses access to the app, and Composio forgets the sign-in. You can connect it again at any time.
Related
- MCP servers: add your business's own tools to Piste.
- Approvals: what Piste asks before doing, and who can approve.
- Proposals and cards: how cards work in Slack and on the web.