Kia ora, Alex

3 accounts · last synced 6 min ago

Net worth

$412,680.00

Up $3,240.00 this month

Spendable balance

$4,918.50

After bills & goals

To sort

2 items

Uncategorised transactions

This month's spend

$3,842.10 across 7 categories

PRD-80 — In-chat AI referral cards (proactive entry)

PRD-80 — Proactive SortMe AI: page-aware help + referral nudges

Goal. Let SortMe AI surface an advisor-referral opportunity inside the chat and let the user act on it (or decline) without leaving the conversation. Recommendations render as interactive cards — headline, approved body copy, actions — not as markdown text; the referral uses the same form and pipeline as the Advice page.

This variant — proactive entry. The user tapped the dashboard pill "There are 3 growth opportunities ready for you", which opened the chat. SortMe AI greets, then shows ONE full card (the mortgage refix). The other two opportunities stay behind a quiet "2 more opportunities when you're ready" row that expands to preview chips.

One card at a time. Only the top opportunity shows as a full card. Never 2+ stacked full cards in one message.
Roll-up chips. Tapping the quiet row reveals compact preview chips (icon + headline + one-line preview). Tapping a chip expands it into its full card in place, with the same actions.
Not now. Collapses a card to a quiet acknowledged row and snoozes that recommendation for 30 days; the AI does not raise it again in the conversation.
Talk to an adviser. Opens the referral form inline in the stream (a conversational step) — the exact AdvisorReferralModal fields. On submit the card flips to its quiet "Matched to Adviser" state and SortMe AI posts a confirmation bubble (phone number + 24-hour expectation). The confirmation lives in the chat bubble only — no duplicate footer text in the card.
Submission failure. The form stays open with all typed details preserved; a red inline banner sits above the button ("We couldn't send your request — check your connection and try again"); "Match Me" becomes the retry. The button is disabled while submitting so a double-tap can never create duplicate referrals. No AI failure message is posted.

Screens (?screen=…). default (landing) · chips · dismissed · form · submitting · error · referred. Each state is addressable via the ?screen param; the live click-through also flows between them via the card actions.

Faked vs real on build. Faked: the AI text, the recommendation selection (which card leads), and the submit API (a timer). Real on build: the AdvisorReferralModal fields + the shared advisor-referral pipeline; the advice-engine approved copy (config/advice_recommendations.php — advice_mortgage_rate_review, advice_kiwisaver_no_goal, advice_idle_cash); and the lead-selection rule (topic-first, otherwise P1 > P2 > P3, same as the Advice page).

Note. There is no _kit/screens template for a chat overlay, so this is a chrome-less-overlay case: the feature surface is the chat popup over a dimmed, simplified Overview backdrop. The transactions template staleness that sync.mjs flags is unrelated to this feature.