Get the agent's decisions in Slack
Connect a workspace to a Slack channel: the agent's decisions as it makes them, the bills waiting for approval with a Review button each, /vestiarion for what is safe to spend and waiting, and stopped payments decided from Slack when an owner allows it.
Connect your workspace to Slack, and a channel your team picks gets what the agent decided, a minute after it decides, with each bill still waiting for approval and a button to review it in Vestiarion. Each member connects their own Slack account to ask what is safe to spend or what waits, and to pause the agent. An owner or admin can add an invoice from a message in Slack. When an owner allows it, a payment the agent stopped can be approved and paid, rejected, or returned to the agent from its message in Slack, under every check Vestiarion makes in the console.
1.Connect Slack
An owner or admin connects Slack, once per workspace. Open Settings and find the Slack section.
- Choose Add to Slack. Slack opens and asks you to pick the channel the agent's decisions go to. A private channel your finance people are in is a good choice: everyone in it sees the payments.
- Choose Allow. Slack sends you back to Settings, which says "Slack is connected. The agent's decisions now go to the channel you picked."
- The section now names the Slack workspace and the channel. The ledger records
slack_installed, and your own Slack account is connected already.
To pick another channel later, an owner or admin chooses Reconnect Slack in the same section; members stay connected, and the limit stays. One Slack workspace serves one Vestiarion workspace. If Settings says "That Slack workspace is already connected to another Vestiarion workspace.", remove it from that one first. Anyone else sees "An owner or admin connects Slack." instead of the button.
2.Connect your own Slack account
The channel's messages reach everyone in the channel. To ask Vestiarion something, or to press a button on a message, each member connects their own Slack account to their own membership:
- In Slack, type
/vestiarion connect. Only you see the answer: a link that works once, for 10 minutes, and only for you. - Open it. Sign in to Vestiarion if you are not signed in. The page, Connect your Slack account, says which Slack account will act as you, in which workspace, and with which role.
- Choose Connect my Slack account. The page answers "Connected. Back in Slack, try /vestiarion today." and the ledger records
slack_member_connected.
A Slack account acts as you only after you confirm it on that page, signed in. Connect only an account that is yours.
3.What the channel receives
After each cycle, the channel gets one message listing what the agent decided since the last one: what it paid, scheduled, released or received, what it stopped, and the early payment it negotiated (its offers, a supplier's answer or counter, its answer, an offer it withdrew), each with why, and links; a milestone's opens its own row on Contractors. While deciding from Slack is off, the default, the bills it held or flagged for a person, or asked details for, and that still wait, end the message, each with a button to review it. A payment that has not confirmed 15 minutes after it was submitted to Circle is posted within minutes, without waiting for a cycle.
Acme · the agent decided 3 things
Paid Centronex 0.35 USDC · 26 s after it was added; Circle confirmed it on Arc testnet.
DeepSeek decided, as the written policy would. Checks passed: purchase order and goods, the 2.00 USDC limit, screening.
[Arc testnet transaction] [How it decided]
2 bills wait for approval:
3.00 USDC · Jiren · held: Code stopped it: it is above the counterparty's payment limit. [Review]
1,250.00 USDC · Northwind Hosting · flagged: The bank details on the invoice differ from the ones on file. · needs two approvals, an accountant can co-sign [Review]
Opening a link never approves anything.- Arc testnet transaction opens the payment on the explorer. For a workspace on Arc mainnet, it reads Arc mainnet transaction.
- The bills that still wait for approval come last, under how many wait, one each: the amount and its currency, the payee, whether the agent held or flagged it or it is waiting for details, why, and Review, a button that opens the bill's own card in Vestiarion.
- When a check in code stopped a bill, such as its payment limit, the payee lock or the cash a payment needs, the line says what stopped it, as its row on Bills & receivables does: "Code stopped it: it is above the counterparty's payment limit." A bill the agent held itself gives the first sentence of the agent's reason. When Vestiarion cannot read what stopped a bill, the line gives the agent's sentence too; the bill's card on Approvals says the rest.
- A bill above the workspace's figure for two approvals says "needs two approvals". While an owner lets accountants co-sign, it says "needs two approvals, an accountant can co-sign".
- Only bills that still wait are listed there. A message lists at most ten bills, then "…and 3 more in Approvals", with a link to Approvals, for the rest.
- A stopped bill that is not listed there keeps its own place among the decisions, as the agent decided it, with Decide in Approvals, which opens its card, or Add details for one it asked details for. That is a bill a person approved, rejected or returned before the message went out, or every stopped bill when Vestiarion could not check which still wait. While deciding from Slack is on, no bill is listed there: each stopped bill keeps its own place, with its buttons (section 5).
- In shadow mode, a payment held for your verdict keeps its own place among the decisions, with Give your verdict.
- When the wallet will run short, the channel is told how much, by when and what the agent is doing about it, and told again only when that changes. See When the cash will run short.
- The channel is told only about decisions made after Slack was connected. A busy cycle's message says how many more decisions are in the console.
In these messages and in /vestiarion waiting, hidden direction and zero-width characters are removed from every value that comes from a bill or from the agent, such as a payee's name or the agent's reason, so no name can make a line read as another bill's, and Slack makes no link or mention of a web address, a channel or an @name inside one. Slack's own formatting marks in a value, such as * or _, still format, but make no link or mention. The only links are the ones Vestiarion adds, and Slack shows no preview of them. A wallet address is shortened to its first and last four characters.
Review a bill
Review opens the bill's card on Approvals in Vestiarion. The link carries no token: you sign in as usual, and the card shows what you can do with your role. Opening a link never approves anything, and pressing Review decides nothing in Slack. You decide the bill there, with Approve and pay, Reject or Return to agent, under every check Vestiarion makes. A bill waiting for details opens on Approvals too, where an owner or admin adds them with Add details.
4.Ask it
| Type | What you get, seen by you alone |
|---|---|
/vestiarion today | Safe to spend today, what is due in the next 30 days, how many payments wait for a person, and what the agent pays next |
/vestiarion waiting | Each payable or milestone waiting for a person, why it waits, and a link: Review for a payable, Contractors for a milestone, which opens its own row there. When a Review link is listed, the answer ends with "Opening a link never approves anything." A payable a check in code stopped says what stopped it; the rest give the first sentence of why the agent stopped them. A bill asked for details says it is waiting for details. In shadow mode, a payment held for your verdict says it waits for your verdict, with Give your verdict |
/vestiarion ledger | Whether the signed ledger is intact, checked the way Verify hash chain checks it |
/vestiarion pause [reason] | Stops the agent, for an owner, admin or approver. The channel where you typed it sees that you paused it. Resuming stays in Vestiarion |
/vestiarion disconnect | Disconnects your Slack account |
/vestiarion help | What it does |
Every answer is read from your workspace and written by code.
5.Decide a payment from Slack
Deciding payments from Slack is off until an owner allows it. In the Slack section, under Deciding payments from Slack, an owner fills in Limit (USDC), the most a payment approved from Slack may be, and saves. Leaving it empty turns it off again; while it is off, the section says "Deciding payments from Slack is off" and the channel's message lists the bills still waiting for approval, each with Review, which only opens it in Vestiarion. Each change is recorded as slack_decisions_limit_changed.
Once it is on, a payable the agent stopped gets buttons under its message:
Held Jiren 3.00 USDC for you.
The invoice is above Jiren's 2 USDC payment limit.
[Approve and pay] [Reject] [Return to the agent] [Decide in Approvals]The bills still waiting are then no longer listed apart at the end of the message: each keeps its own place among the decisions, with these buttons.
- Approve and pay, in a workspace on Arc testnet, when the payable is in USDC, its payee is paid on Arc testnet rather than on another chain, its amount is within the limit, its payee's address is confirmed, and its invoice did not ask to be paid to another address than the one on file. Slack asks you first, in a box titled Approve and pay? that names the amount, the payee and the address, shortened to its first and last four characters. It names an early-payment discount, which comes off if still due, and a late fee, "A late fee of 1.5% a month starts Oct 30, 2026; it is never added to what is paid."
- Reject, after Slack asks you to confirm it.
- Return to the agent, which hands it back for the agent to decide again, usually within a minute.
The limit is for Approve and pay alone: Reject and Return work at any amount.
When Approve and pay is not offered, the message says why under the buttons, after "Approve it in Vestiarion:", and you decide it in the console.
On Arc mainnet, Approve and pay is never offered in Slack. With deciding from Slack on, the message keeps Reject and Return to the agent, which work as on Arc testnet, and reads under its buttons "Approve it in Vestiarion: It is on Arc mainnet, where payments are approved in Vestiarion."
In shadow mode, a payable held for your verdict comes with no buttons: the message says the agent decided to pay it and that it waits for your verdict, and Give your verdict opens it in Vestiarion, where you agree or disagree. A button on an earlier message about it refuses until a verdict is given.
A button acts as you, with your role in the workspace as it is when you press it, and runs the same checks as Approve and pay in Approvals: you cannot approve a payable you entered unless you are the workspace's only approver, a payee screened high risk is refused, the operating wallet must hold the amount, and a payable is decided once, whoever presses first. Above the workspace's figure for two approvals, its rules apply instead: whoever entered a payable gives one of its two approvals only when no one else can, and the funds are checked by the approval that pays it. Slack adds two of its own: a button works only on the payable as its message showed it, and never confirms a changed address. If the payable was decided, or the agent decided it again, since the message was posted, you are told "This payable changed after this message was posted. Open Vestiarion to see it as it is now." Approve and pay is also refused when the payee's address is no longer the one the message was posted with: a new address is confirmed on Counterparties, in Vestiarion. A button older than 7 days answers "This button no longer works". Someone who has not connected their Slack account is told "Connect your Slack account to Vestiarion first", and nothing is decided.
What you decide is rewritten into the message for the channel: "Approved by" you, then "Circle confirmed the payment on Arc testnet." with the transaction, or, while Circle has not confirmed it, that the payment was submitted and waits for Circle; or "Rejected by", or "Returned to the agent by". Above the workspace's figure for two approvals, your approval pays nothing yet: the message says you approved it, then "One more approval, by another person, pays it.", and keeps its buttons for a second person, whose approval pays it. A refusal is shown to you alone. In the ledger, the decision is the same approval_paid, approval_rejected or approval_returned entry the console writes, with via: "slack" and the id of your Slack link.
6.Add an invoice from Slack
An owner or admin can add a payable from an invoice in Slack: a PDF, an .eml or .txt file of at most 4 MB attached to a message, or the invoice's text in the message itself.
- On the message, open More actions and choose Add invoice.
- Vestiarion reads it the way From a document on Bills & receivables reads one, and answers you alone with every field it read, what to check, and The model's note: when there is one.
- Choose Add, goods received or Add, not received yet to add it, or Cancel, which answers "Not added."
The payable is added exactly as one added on Bills & receivables: the ledger's create_invoice entry names you, and adds via: "slack", the id of your Slack link and the hash of the document. The document itself is not kept. The agent usually decides within a minute, and its decision is posted to the channel like any other. A draft can be added once, within an hour; after that you are told "This draft was already used or has expired."
When the invoice's vendor matches no counterparty in the workspace, or it has no amount or due date, Vestiarion says what is missing and links to Bills & receivables, where you can add it by hand. An approver, an accountant or a viewer is told "Only an owner or admin can add invoices."
Vestiarion reads only the message you chose it on, and Slack lets it open a file only in a channel it is in: for a file shared anywhere else, type /invite @Vestiarion in that channel first. If Slack was connected before this was possible, Vestiarion answers that it cannot open files in this Slack yet: an owner or admin chooses Reconnect Slack once, and Slack asks them to allow it.
7.Disconnect
- Your own account: type
/vestiarion disconnectin Slack, or choose Disconnect my account in the Slack section. The ledger recordsslack_member_disconnected. - The whole workspace: an owner or admin chooses Remove Slack. Vestiarion removes the app from the Slack workspace, and every member's Slack link goes with it. Removing the app in Slack does the same. The ledger records
slack_uninstalled. - If someone is removed from the workspace, their Slack link goes with their membership.
What Slack receives
Workspace and counterparty names, amounts, the agent's reasons, links to Vestiarion and to the explorer of the workspace's network, Arc testnet or Arc mainnet. A wallet address only shortened to its first and last four characters; never an email, a key or a full address. The app reads no message in your Slack but the one someone chooses Add invoice on: it asks for three permissions, to answer /vestiarion, to post to the channel you picked, and to read a file someone chooses.
For the person who runs the deployment
Create the Slack app from integrations/slack/manifest.yaml (api.slack.com, Create New App, From a manifest), and set SLACK_CLIENT_ID, SLACK_CLIENT_SECRET and SLACK_SIGNING_SECRET. Without all three, the Slack section does not show and the Slack routes answer 404; every request from Slack is checked against the signing secret. Slack checks the events URL when it is saved, so add Event Subscriptions once the deployment serves it. To let other Slack workspaces connect, turn on public distribution under Manage Distribution. An app created before Add invoice existed needs the manifest saved again on its App Manifest page, and each workspace connected again with Reconnect Slack.