Step 1: Message Ingestion
When you text your BudgeFlow number, the message arrives at a carrier-grade SMS gateway in under one second. The gateway delivers the message to BudgeFlow's processing pipeline, which identifies the sender (your phone number), associates it with your account, and queues the message for parsing.
Step 2: Natural Language Parsing
BudgeFlow's parser extracts several fields from your message:
- Merchant or description: "Starbucks", "grocery run", "electric bill"
- Amount: "$6.40", "64", "112.50"
- Date: Defaults to today unless you include "yesterday", "last Tuesday", or a specific date
- Note: Any text in parentheses is stored as a transaction note
- Command: If the message starts with a known command keyword (b, balance, summary, split, owe, remind, fix), it triggers that command handler instead of the expense flow
The parser is designed for messy, natural-language input. "Coffee 4.8" works. "had lunch at chipotle cost me 14 bucks" works. "paid electric 94 dollars" works.
Step 3: AI Categorization
Once a merchant and amount are extracted, a categorization model maps the merchant to one of your budget envelopes. The model uses:
- Merchant name normalization (e.g., "SBX" → "Starbucks" → Dining)
- Category signals from the merchant name itself
- Your personal categorization history (if you've corrected a category before, the model remembers)
- Fallback to a best-guess category when confidence is low, flagging it for your review
Categorization accuracy improves over time as the model learns your personal merchant patterns.
Step 4: Envelope Deduction and Balance Update
The categorized amount is immediately deducted from the matching envelope. If you have alerts configured, the system checks whether the deduction has pushed the envelope past 80% or 100% of its monthly budget. If so, an alert SMS is queued alongside your confirmation reply.
The entire process — parse, categorize, deduct, reply — completes in under two seconds for 95% of messages.
Step 5: The Reply
You receive a confirmation reply with:
- The merchant and amount logged
- The envelope it was categorized to
- Your remaining balance in that envelope
- An alert flag if you're near or over budget
Example: "Starbucks $6.40 → Dining ✓ Remaining: $43.60 / $150"
If you reply "fix" within 60 seconds, you're prompted to select the correct category. This feedback trains your personal model.
Related resources
Frequently Asked Questions
Q1.How accurate is the AI categorization?
For well-known merchants (Walmart, Starbucks, Shell, Netflix), accuracy is above 95%. For local merchants or ambiguous names, accuracy is lower initially but improves as you correct it. Most users report fewer than 2–3 corrections per week after the first month.
Q2.What if my text is ambiguous or malformed?
BudgeFlow's parser is designed for informal input. If it can't confidently extract an amount, it will reply asking for clarification: 'Got your message — what was the amount?' You reply with the number and the expense is logged.
Q3.Does BudgeFlow process messages in real time?
Yes. 95% of messages are processed and replied to within 2 seconds. During peak traffic periods (typically 7–8pm local time), processing can take up to 5 seconds.
Q4.Is my message content stored?
Yes — the parsed transaction data (merchant, amount, category, date) is stored in your account. Raw message text is retained for up to 90 days for dispute resolution, then deleted.
Q5.What happens if I send a message to the wrong number?
BudgeFlow replies to your registered number only. If you accidentally text the wrong number, simply text your BudgeFlow number to log the expense.
Start today
Budget by text — free for 14 days
No app to download. Set up your envelopes in 10 minutes. Log your first expense with a text.