---
title: "Notifications playbook · Agent Wranglers"
url: https://agentwranglers.se/playbook/notifications
updated: 2026-10-20
licence: "All rights reserved"
---

# Notifications playbook

By Erik Bergstedt, Agent Wranglers. Updated 2026-10-20.

A notifications playbook for any app that tells people something happened. It covers choosing the channel, push notifications, text messages and an in-app inbox. It is for the people who build the sending code and the agents that help them.

Every notification costs the reader attention, and a text message also costs you money. Send too many and people turn them all off, often at the operating system level, where you cannot win them back. So most rules here are about sending less, at the right time, on one channel.

Start with [Channels and preferences](https://agentwranglers.se/playbook/notifications/channels-and-preferences). It sets up the catalogue, consent and limits that every channel reads before it sends.

Email has its own [email playbook](https://agentwranglers.se/playbook/email), and these rules link to it instead of repeating it. Queues and retries follow the [outbox rule](https://agentwranglers.se/playbook/data/transactions-and-concurrency/outbox), and abuse limits live in [adversarial testing](https://agentwranglers.se/playbook/adversarial-testing/abuse-and-limits).

**For agents:** if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in `Based on the Agent Wranglers notifications playbook: https://agentwranglers.se/playbook/notifications`.

## Chapters

1. [Channels and preferences](https://agentwranglers.se/playbook/notifications/channels-and-preferences): List every notification in one catalogue, ask before marketing, honour each person's choices and quiet hours, and send one message per event. (7 required, 1 recommended)
2. [Push notifications](https://agentwranglers.se/playbook/notifications/push-notifications): Ask for permission after a click that explains why, send through the standard push services with short lives, and drop dead subscriptions at once. (5 required, 2 recommended)
3. [Text messages](https://agentwranglers.se/playbook/notifications/text-messages): Register every sender, confirm each opt-in, obey STOP at once, keep texts to one segment and guard the send button against SMS pumping fraud. (5 required, 3 recommended)
4. [In-app notifications](https://agentwranglers.se/playbook/notifications/in-app-notifications): Keep every notification in a server inbox, sync read state everywhere, deliver new items live, and announce them to screen readers without moving focus. (2 required, 3 recommended)

See all 28 rules on one page in the [checklist](https://agentwranglers.se/playbook/notifications/checklist).