callout
A message a person must notice, such as a warning that an agent's hand-offs tripled, with an optional link to act on it.
tone says what kind of message it is: info (the default), ok, warn or bad; there is no neutral callout.
title is a few words, text the message (up to 1,000 characters). action adds one link to a screen of this
app: { label, to }. The tone names the meaning; the theme decides the colour.
When to use
Use it when
Something changed that a person should act on, such as an agent handing off three times as often.
A result a person waits for, such as a test run that passed.
A rule that applies to the whole screen, such as the 72-hour hold on results.
Use another block when
A decision on a row, approved or rejected here.
Use approval
An agent's hand-offs went up
Apps agent
Hand-offs tripled after the expense tool update on Monday; 94 tickets went to people instead.
callout:
tone: warn
title: Apps agent
text: Hand-offs tripled after the expense tool update on Monday; 94 tickets went to people instead.
action: { label: Open the agents, to: agents }
<a id="callout-1"></a>
> warn: **Apps agent** — Hand-offs tripled after the expense tool update on Monday; 94 tickets went to people instead.
- #callout-1.open "Open the agents": GET /a/catalog/agents · opens the screen · approval: no · cost: free
A test run passed
Ready to turn on
Test run: 83 of 100 procurement tickets closed the same way a person closed them.
callout:
tone: ok
title: Ready to turn on
text: 'Test run: 83 of 100 procurement tickets closed the same way a person closed them.'
<a id="callout-1"></a>
> ok: **Ready to turn on** — Test run: 83 of 100 procurement tickets closed the same way a person closed them.
A rule for the whole screen
72-hour hold
A closed ticket counts as a result only after 72 hours without a reply from a person.
callout: { title: 72-hour hold, text: A closed ticket counts as a result only after 72 hours without a reply from a person. }
<a id="callout-1"></a>
> info: **72-hour hold** — A closed ticket counts as a result only after 72 hours without a reply from a person.
States
ready
always drawn; it reads no data
| Action | Needs | Does | Reversible | Confirm page | Cost |
|---|---|---|---|---|---|
| open | none | navigates to the screen | yes | never | free |