Skip to content

docs(mobile-phone-waterfall): add plan availability note for trial users - #2297

Merged
george-dilthey merged 1 commit into
mainfrom
docsbot/doc-2041-intercom-tag-0824-ab472e2f
Aug 26, 2026
Merged

docs(mobile-phone-waterfall): add plan availability note for trial users#2297
george-dilthey merged 1 commit into
mainfrom
docsbot/doc-2041-intercom-tag-0824-ab472e2f

Conversation

@george-dilthey

Copy link
Copy Markdown
Contributor

What changed

Added a plan availability note to docs/mobile-phone-waterfall.md — one sentence before the setup steps stating that the Mobile Phone waterfall requires a Launch plan or higher and is not available on free or trial plans.

Why

An Intercom ticket (conversation #215475571632835) was flagged where a trial user asked about mobile/direct-line phone enrichment and discovered it wasn't available. Fin and the human agent (Aamish Samotra) both correctly answered that phone enrichment requires a paid plan — but the answer came from plans-and-billing.md and building-a-data-waterfall.md, not from the Mobile Phone waterfall doc itself.

mobile-phone-waterfall.md had zero mention of plan restrictions. A trial user reading this page for setup instructions would receive complete how-to steps with no warning they'd be blocked from using it. This creates a Fin retrieval failure: if a trial user asks "how do I use the Mobile Phone waterfall?", Fin retrieves this page and gives setup instructions without the critical restriction.

The restriction is already correctly documented in:

  • plans-and-billing.md lines 56 and 150–152
  • building-a-data-waterfall.md lines 173–183 (which says "Providers that can return phone numbers — such as PDL (People Data Labs), Bytemine, and others — require the Launch plan or higher")

Source link(s)

Uncertainties

None. The plan restriction is explicitly documented in two other docs and confirmed by the verifier sub-agent.

Related observations

The mobile-phone-waterfall.md doc could also note the workaround for trial users who want partial waterfall functionality (remove phone-number providers from the sequence), but building-a-data-waterfall.md already covers that at lines 183–184. Cross-linking is handled by the reference to plans-and-billing.md#trials in the added note.

Closes DOC-2041

@linear-code

linear-code Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

DOC-2041

@george-dilthey
george-dilthey marked this pull request as ready for review August 26, 2026 14:51
@george-dilthey
george-dilthey merged commit 98a7ef2 into main Aug 26, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant