Slash commands
SAFIA only responds to two slash commands./start
Sends a welcome message and clears your current chat history. Use it when you want to begin a fresh conversation — for example, after switching topics or if a previous session went off the rails.
Hi! I’m SAFIA, your personal finance chat companion. What can I do?How to use? Send text, voice, or a clear photo of a receipt/payslip. /start = restart conversation /bantuan = quick info & limits Got questions? Just send a message 🙂
- Track income, expenses, and investments (stocks, gold, crypto, etc.)
- Check prices or exchange rates (e.g. gold today, Bitcoin, USD to IDR)
- Help with debt, savings, financial news, education, and reminders
/start resets your chat history but does not delete your expenses, assets, or long-term memories. Your financial records stay safe./bantuan
Shows a quick-reference help message with a summary of what SAFIA can receive and your current daily limits. Useful when you forget whether SAFIA accepts voice messages or need a reminder of the message cap.
SAFIA Help Commands /start — restart conversation /bantuan — this message SendLimit: max 25 messages per day per account (resets daily). Tip: write amounts and dates clearly for accurate records.
- Text — ask about money, investments, prices, exchange rates, etc.
- Voice — transcribed to text, then answered like a regular chat
- Photo — clear receipt or payslip (I’ll read the contents)
Natural language interaction
Every other interaction with SAFIA is just a normal message. There are no special keywords or rigid formats — write the way you would text a colleague.Track an expense
“I spent 45k on coffee this morning”
Check a price
“What’s the Bitcoin price right now?”
Review your finances
“How much did I spend on food this month?”
Get advice
“Should I rebalance my portfolio this week?”
Real-time status messages
While SAFIA processes your request, it shows a live status message so you know what’s happening. The message updates as SAFIA moves through each step — you never have to wonder whether it received your input.| Status shown | What SAFIA is doing |
|---|---|
Listening... | Downloading your voice file from Telegram |
Thinking... | Calling the AI model and any needed tools |
Scanning document... | Running vision extraction on your photo |
Rate limits
SAFIA allows 25 messages per user per day. The count resets at midnight UTC each day. Each of the following counts as one message toward your daily limit:- A text message
- A voice message (after transcription)
- A photo (after scanning)
You’ve reached the daily limit of 25 messages. Please try again tomorrow, or reset the conversation if needed.
Chat context window
SAFIA remembers your last 10 messages within a session, stored temporarily in Redis. This lets it follow the flow of a conversation — you can say “make it monthly instead” and SAFIA will understand what “it” refers to. Context expiry affects only the short-term conversation thread. Your expenses, assets, reminders, and long-term memories are stored separately and are always available regardless of session age.Access control
Depending on how SAFIA is deployed, access may be open to everyone or restricted to an allowlist of approved Telegram user IDs. This is configured by the bot administrator in the admin dashboard. If your account is not on the allowlist, SAFIA will respond with:
Access denied — you are not authorised to use this bot.
Your Telegram ID: 123456789
Share this ID with the bot owner to request access.
Copy the Telegram ID from that message and send it to the person who set up the bot. They can add you via the admin dashboard without any downtime.