QuickSpend now really quick, finally

QuickSpend là app iOS mình build để log chi tiêu nhanh bằng câu nói tự nhiên — và phiên bản 3.0 sắp ship, cuối cùng cũng đúng cái tên Quick. Đặt tên Quick từ v1, sau hai phiên bản mới thấy hơi sai sự thật, giờ thì thấy hợp lí rồi =)).

"It's done. It's over." — Frodo, The Lord of the Rings.

Vấn đề: app "quick" nhưng vẫn chưa đủ quick#

QuickSpend ban đầu mình build cho chính mình dùng — eat own dogfood, ít nhất để sản phẩm mọi người dùng được thì mình phải dùng được và thấy ổn trước đã. Dùng vài tháng thì lộ ra một điều khá đau lòng: chính mình vẫn quên ghi chi tiêu đều đặn =)).

Lý do thì quá đơn giản — vấn đề chắc chắn ai cũng gặp: quá lười, quá vội để note lại chi tiêu.

Cuối tháng nhìn lại chart, data thưa như tóc mình sau 30 tuổi. Vậy là vấn đề không nằm ở app, nó nằm ở bước phải mở app. Cái cần loại bỏ chính là cái đó. Mình muốn một flow mà user chỉ cần nói "chi tiêu nhanh 50k trà sữa" là xong, không cần tap gì hết, không cần nhìn màn hình, đẹp như mơ.

Hướng xử lý: đẩy entry point ra khỏi app#

Trên iOS có hai con đường rõ ràng:

• Nói thẳng với Siri — kịch bản đẹp nhất, không tap gì hết, sang chảnh như quảng cáo Apple.
• Shortcuts — backup thực dụng cho khi Siri trở chứng. Trigger được bằng tap, widget, hoặc gọi qua Siri đều ngon.

Siri thì... vẫn ngu ngu, đôi khi mình hỏi giờ Hà Nội còn trả lời sai múi giờ =)). Nhưng Shortcuts là vũ khí mạnh thật trong hệ sinh thái Apple — một khi setup xong nó chỉ là một nút bấm. Nên mình build cả hai, dùng Shortcuts làm safety net để khi Siri drop ball thì user vẫn không bị chặn.

Luồng mới: hai kịch bản#

Kịch bản 1 — qua Shortcut (path luôn work)#

"Hey Siri, chi tiêu nhanh."

Siri trigger shortcut → shortcut hỏi lại "nội dung gì?" → user nói câu tự nhiên (ví dụ "50k trà sữa") → loading → AI parser xử lý.

Hai nhánh tuỳ confidence của parser:

• Confidence cao: app lưu luôn, Siri thông báo "đã ghi", end flow. Không cần mở app, không cần nhìn màn hình, đẹp như mơ.
• Confidence thấp: app mở ra với UI listing transaction được parse, user confirm lưu hoặc cancel. App không tự tin thì cứ hỏi, hơn là lưu bừa rồi user phải vào sửa.

Kịch bản 2 — gọi thẳng app qua Siri (path đôi khi work)#

"Hey Siri, dùng Chi tiêu nhanh để thêm chi tiêu 50k uống trà sữa."

Kịch bản đẹp: Siri hiểu intent, gọi thẳng app, app nhận text Siri đã transcribe sẵn → AI parser xử lý y hệt luồng trên. Đỡ hẳn một bước — user không phải đợi Siri hỏi lại "nội dung gì". Sướng phải không nào?

Đời không như là mơ. Mình test khá nhiều lần, kết quả không hề ổn định =)). Mà oan cho Siri một phần — đào sâu vào API mới phát hiện đây không hoàn toàn lỗi của em ấy: AppShortcutsProvider của Apple chỉ cho phép phrase có parameter khi parameter là AppEntity hoặc AppEnum. Với free-form String (như nội dung chi tiêu), phrase bắt buộc phải open-ended — Siri trigger intent rồi mới hỏi lại "What expense should I add?". Mình sẽ nói thêm ở phần kỹ thuật bên dưới.

Hệ quả: câu kiểu "Hey Siri, dùng Chi tiêu nhanh thêm 50k trà sữa" về mặt API là không declarable được, Siri đoán mò. Đó là lý do Shortcut variant tồn tại — nó là path mình tin được, khi Siri đang có hứng làm việc thì kịch bản 2 mới đẹp.

Nghe đồn với Apple Intelligence thì Siri sẽ thông minh hơn, hy vọng là vậy để kịch bản 2 ổn định hơn trong tương lai. Hiện tại thì mình chưa test được vì đang chỉ có iPhone 15, bạn nào có iPhone 16 Pro hoặc 17 thử giúp mình xem Apple Intelligence có cứu được kịch bản 2 không nhé =)).

Mấy vấn đề khi build feature này#

Đồng bộ ngôn ngữ giữa Siri và app. Trước đó QuickSpend tách ngôn ngữ hiển thị và ngôn ngữ transcribe — user có thể chạy UI tiếng Anh nhưng voice input tiếng Việt, kiểu menu Tây mà order Việt. Khi thêm Siri vào, separation đó vỡ — Siri chỉ nói một ngôn ngữ tại một thời điểm theo system. Mình phải bỏ tách biệt đó, gộp về một locale duy nhất. Trade-off đáng vì consistency quan trọng hơn flexibility mà chắc chỉ có mỗi mình dùng.

Tên app khi Siri gọi. Như đã thấy ở kịch bản 2 — Siri nhận diện app name không ổn định, đặc biệt khi user trộn Anh–Việt trong câu lệnh. Mình thử nhiều phrasing khác, kết quả tốt nhất hiện tại vẫn là: đừng tin Siri, dùng Shortcut.

Liên quan đến tên app nữa, mình đã thêm tên app theo locale: tiếng Việt là Chi tiêu nhanh, tiếng Anh vẫn là QuickSpend, còn tiếng Nhật, tiếng Tây Ban Nha nữa — không nhớ là gì, dùng translator dịch =)).

Với tên app như vậy, khi trigger bằng Siri sẽ có câu kiểu:

"Hey Siri, thêm chi tiêu vào Chi tiêu nhanh."

Nghe nó lủng củng sao sao ấy, nhưng chưa biết làm sao vì để Siri nhận diện thì vẫn phải kèm tên app.

Phần kỹ thuật (skip OK nếu không quan tâm)#

Bốn thành phần chính:

• App Intent (AddExpenseIntent) — define action với @Parameter text + requestValueDialog ("What expense should I add?"). Return type IntentResult & ShowsSnippetView & ProvidesDialog để Siri vừa đọc dialog vừa show snippet card. Đặt openAppWhenRun = false để happy path chạy hoàn toàn ngoài app — không launch UI, Siri đọc kết quả là xong.
• AppShortcutsProvider + localized phrases — declare phrases EN với \(.applicationName) interpolation, các locale vi/ja/es seed vào AppShortcuts.xcstrings. Limitation đã nhắc ở trên: phrase chỉ accept parameter là AppEntity/AppEnum. Với free-form String thì phrase bắt buộc open-ended, Siri phải hỏi value qua dialog — đây là root cause của kịch bản 2 flaky.
• Snippet view + confirm flow — ParsedExpenseSnippetView là SwiftUI view render inline trong Siri card. Confidence ≥ 0.9 → .result(dialog:) auto-save, Siri đọc xác nhận, end flow. Confidence thấp → requestConfirmation(actionName: .log, dialog:, snippet:) ra card có nút Cancel / Log. Edge case khó chịu: label nút lấy từ system enum ConfirmationActionName, localize theo system locale chứ không theo app language — chưa fix được.
• Bundled Shortcut "Quick Expense" — chain Dictate Text → AddExpenseIntent, giúp user nói liền một mạch thay vì đợi Siri hỏi lại "nội dung gì". Đây là Shortcut cài qua link "Add to Shortcuts" ngay trong app.

Code chi tiết hơn để dành bài khác — bài này dài quá thì các bạn lại skip mất.

Tổng kết#

Sau patch 3.0, QuickSpend cuối cùng cũng đúng cái tên Quick:

• ✅ Voice-first flow: log chi tiêu không cần mở app trong happy path.
• ✅ Shortcut safety net: luôn có path ổn định khi Siri trở chứng.
• ✅ AI parser auto-save khi confidence cao — Siri thông báo, không gián đoạn flow của user.

Điểm chưa ổn:

• ❌ Kịch bản "gọi thẳng app qua Siri" còn flaky. Mình đổ lỗi cho Siri, không nhận =)).
• ❌ Chưa test được với Siri có Apple Intelligence vì chưa lên đời máy xịn hơn iPhone 15. Bạn nào có iPhone 16 Pro hoặc 17 thử giúp mình, nếu Apple Intelligence cứu được kịch bản 2 thì mình sẽ rất biết ơn.

Feature này thực sự hữu ích với chính mình — ba ngày qua data trong app full hơn cả tháng trước cộng lại. Nếu các bạn cũng dùng QuickSpend, update lên 3.0 khi nó ship và quẩy thử. Feedback gì cứ ib mình hoặc gửi qua form feedback trong app — mình đọc hết.

Còn nhiều thứ phải cải thiện trong luồng này:

• Cho user edit trực tiếp transaction trong UI confirm khi parser nhầm — thay vì chỉ save / cancel.
• Polish prompt để parser thông minh hơn, handle được nhiều cách nói tự nhiên hơn của user.
• Tìm thêm hướng tối ưu luồng — bớt step, bớt loading, bớt phụ thuộc Siri nếu có thể.
• Khi có điều kiện nâng máy lên dòng có Apple Silicon hỗ trợ Apple Intelligence (iPhone 15 Pro trở lên), mình sẽ research Foundation Models framework (WWDC 2025) — Swift API gọi thẳng model ~3B on-device của Apple, có guided generation và tool calling. Hứa hẹn parser chạy hoàn toàn offline, không cần gọi cloud.

Hy vọng sẽ có bài kế nữa về QuickSpend — nếu có người dùng thật thì mình mới có động lực update tiếp =)).

Hẹn gặp lại ở bài sau.