Full DM catalog — current vs ideal

1 · The problem in one line

A single shared reel used to trigger 5-6 message bubbles: pulling photos → places → insight → milestone → new-country → nudge. Each "rich" DM also split into a text bubble plus a separate button bubble, so the real count was even higher.

2 · The shape now (the rule)

Every save resolves to at most three logical DMs, in order:

1. Instant ack — fired the moment the share lands, before extraction. Got it - pulling the travel spots from this one. One sec (reel) / Got it - let me pull all the photos. One sec (carousel).
2. Result DM — exactly one. Its text bubble leads with a one-sentence summary, a blank line, then the places list. The action button is its own separate bubble (section 2b).
3. Moment DM — at most one, only when warranted. A single priority pick (milestone > new-country > nudge). The old insight DM is gone — that one-liner now leads the Result DM as the summary, so it never costs its own bubble.

2b · How an Instagram DM actually renders

A plain text message carries the long content (summary + header + places) up to ~1000 chars, but cannot have a tappable button. A "special" message (button / generic template) is the only way to attach a tappable web_url button, but its text is an ~80-char title — it cannot hold the long places list.

So the button is always its own bubble. A Result DM is physically two bubbles: the plain-text list, then a separate special message carrying just the CTA. Below, the dashed bubble labelled special message is that detached CTA — never part of the text bubble above it.

3 · Root cause — three uncoordinated layers (before)

4 · Before / after count (logical DMs)

Part A · The save-flow cases

A1 · Plain reel, 1-5 spots, fast path 2 DMs

Now: 2 logical DMs (ack + result) → 3 visible bubbles.

A2 · Plain reel, 6+ spots (teaser) 2 DMs

A3 · Reel into a new country 3 DMs

The new-country line is the single Moment DM — milestone > new-country > nudge, one wins.

A4 · Reel lands on a save milestone 3 DMs

A5 · First save ever 3 DMs

Guests get ✨ Open Compass (reveal token) spliced into the CTA instead of the bare collection URL.

A6 · Itinerary reel (day-by-day) 2-3 DMs

A7 · Destinations-only reel 2 DMs

A8 · Slow path (thin caption) 2 DMs

A9 · Carousel success 2 DMs

A10 · Carousel + milestone 3 DMs · ceiling

A11-A12 · Carousel can't resolve 2 DMs

These two are plain text with no button — a single bubble each, no special message.

A13-A14 · Re-shares 1 DM

Re-shares skip the ack (detected during dedup, before extraction) and carry no Moment DM.

A16-A17 · Misses 1 DM

Part B · The copy catalog (current → now)

Because the voice stayed sentence case, most copy is unchanged. The real diffs are the new reel ack, the summary lead line, the reworded new-country moment, and Title-Case button labels dropped to sentence case.

B1 · Save acks & results (where the work is)

B2 · Moment DM copy (one fires, by priority)

Nudges keep the 1-per-24h cooldown (bot:nudge_sent:{userId}), so the nudge rarely wins the slot.

B3 · Button labels — Title Case → sentence case

B4 · Everything else (unchanged): onboarding / OTP, the not-linked greeting, conversational greetings, quick-reply responses, guest caps, carousel failures, and the edge / failure messages keep their existing sentence-case copy — already terse and correctly capitalized, so the re-voice left them as-is.

Part C · What changed in code

Verified: tsc --noEmit clean · eslint clean (incl. the no-AI-tell rule) · vitest run → 1171 passed, 1 skipped, including the 9 new assertions.