EzyTracker Bot — User Guide

📋 Overview

Self-register an account, then log expenses (each gets a short SID). Group expenses into records (e.g. Main, Business, Personal). View over flexible date ranges and export PDF. Expenses need an active subscription; registration & billing are open.

/aexp

Add Expense

Log an expense (inline or guided)

/vrexp

View Expenses

today / thismonth / YYYY-MM / range

/etpdf

PDF Report

Export any range as a PDF

/eexp

Edit Expense

Update item/amount/date by SID

/records

Records

Create custom records (Budgets)

/register

Register

Create your account + 7-day trial

🔐 Getting Access

Self-register an account (private chat only), activate with the code, and you get a 7-day trial. A default Main record is created for you.

1

Register

Send /register My Expenses (or just /register for guided). The bot creates a pending account + Main record and gives you a 6-char code.

2

Activate with the code

Send /code YOURCODE. You get a 7-day trial, then /subscribe (RM 5/month).

/register My Expenses

✅ Account Created!

📛 Name: My Expenses
🆔 ID: #9
🏷️ Default record: Main

📋 Verification Code: P4LQ8X

Activate by sending:
/code P4LQ8X

You can add more records later with /addrecord

2:10 PM

/start /cmd

Start & Help

/start shows a welcome with quick-action buttons. /cmd lists every command with usage. Before registering you're asked to contact admin or use the admin bot.

/start

📊 Expense Tracker

Welcome, My Expenses!
📝 Total expenses recorded: 42

➕ Add Expense 📋 View Expenses
📄 PDF Report ❓ Help

2:13 PM

/cmd

📋 Expense Tracker Commands

Add expense:
/aexp it:item am:amount dt:date rc:record
Example: /aexp it:grocery am:50.50 rc:Business

Edit expense: /eexp sid:SID [it:] [am:] [dt:]
Delete expense: /dexp SID
View: /vrexp today | thismonth | YYYY-MM | …
PDF: /etpdf (same ranges)
Records: /records · /addrecord · /delrecord
Account: /register · /code · /subscribe · /editaccountname

2:14 PM

/aexp

Add an Expense

Inline one-liner, or guided (item → amount → date → record). Date defaults to today; record defaults to Main.

Command Format

        # Inline

        /aexp it:<item> am:<amount> [dt:<date>] [rc:<record>]

        # Examples

        /aexp it:grocery am:50.50

        /aexp it:fuel am:80.00 dt:2026-06-20 rc:Business

        # Guided (bare command)

        /aexp  → item → amount → date (or "-" for today) → record

Parameters

Key	Description	Example
it:	Item name (required)	it:grocery
am:	Amount in RM (required, > 0)	am:50.50
dt:	Date YYYY-MM-DD (optional, = today)	dt:2026-06-20
rc:	Record name (optional, = Main)	rc:Business

/aexp it:grocery am:50.50 rc:Business

✅ Expense added!

📝 Item: grocery
💰 Amount: RM 50.50
📅 Date: 2026-06-25
🏷️ Record: Business
🔖 SID: x7k2mp

🗑️ Delete

2:20 PM

⚠ Save the SID for /eexp & /dexp. In guided mode, send - for today's date / Main record.

/eexp /dexp

Edit & Delete Expenses

Edit any field by SID (only the fields you include change). Delete by SID. Both support guided mode if you send the bare command.

Command Format

        # Edit (one or more fields)

        /eexp sid:<SID> [it:] [am:] [dt:]

        /eexp sid:x7k2mp am:55.00

        # Guided edit

        /eexp  → send SID → choose field → new value

        # Delete

        /dexp <SID>

        /dexp  → send SID  (guided)

Edit Fields

Key	Description
sid:	SID of the expense (required)
it:	New item name
am:	New amount
dt:	New date YYYY-MM-DD

/eexp sid:x7k2mp am:55.00

✏️ Expense Updated
━━━━━━━━━━━━━━━━━━━━
🔖 SID: x7k2mp
📝 Item: grocery
💰 Amount: RM 55.00
📅 Date: 2026-06-25
✅ Updated successfully!

2:30 PM

⚠ The SID itself can't be changed. Use /vrexp to find an SID.

/vrexp

View Expenses

View expenses over a flexible range, optionally filtered to one record. Bare /vrexp starts guided mode and lists the accepted ranges.

Command Format

        /vrexp <range> [rc:<record>]

        # Preset ranges

        today | yesterday | thisweek | lastweek

        thismonth | lastmonth | last7 | last30 | thisyear

        # Other formats

        YYYY-MM   (e.g. 2026-06)

        jan … dec  (month name)

        dt:2026-06-15       (single date)

        dt1:start dt2:end   (custom span)

        range:14           (last N days)

        # With record filter

        /vrexp thismonth rc:Business

/vrexp thismonth

📊 Expenses for June 2026 | 🏷️ All Records

📅 2026-06-20 → 🔑 q1w8er 🏷️ Business
📝 fuel | 💰 RM 80.00
---
📅 2026-06-25 → 🔑 x7k2mp 🏷️ Business
📝 grocery | 💰 RM 55.00
---
💰 Total: RM 135.00

2:35 PM

⚠ If you have multiple records, the bot asks which one to view (send - for all).

/etpdf

PDF Report

Export any range (same ranges as /vrexp) as a PDF table — No, Date, Item, Record, Amount — with a total. Optional record filter.

Command Format

        /etpdf <range> [rc:<record>]

        # Examples

        /etpdf thismonth

        /etpdf 2026-06 rc:Business

        /etpdf dt1:2026-06-01 dt2:2026-06-30

/etpdf thismonth

📄 Expense_Report_20260625_143500.pdf 18.4 KB

📄 Expense Report
Period: June 2026
Record: All Records
💰 RM 135.00 | 📊 2 items

2:40 PM

PDF Contents

→ Owner name & period
→ Full table — No, Date, Item, Record, Amount (RM)
→ Total items & total amount

/records /addrecord /delrecord

Records & Account

Records are sub-groupings inside your account (e.g. Main, Business, Personal). Every account starts with Main. Deleting a record removes all its expenses (2-step confirm).

Command Format

        /records              # list all records + expense counts

        /addrecord <name>      # add a custom record (or guided)

        /delrecord <name>       # delete + all its expenses (confirm)

        /editaccountname <name> # rename your account (or guided)

        # Examples

        /addrecord Business

        /delrecord Business  → /delrecord Business confirm:<code>

/records

📋 Records

🆔 #1 | Main (12 expenses)
🆔 #2 | Business (30 expenses)

2:45 PM

/addrecord Personal

✅ Record "Personal" created!

2:46 PM

⚠ /delrecord sends a confirm code; resend with confirm:<code> to actually delete.

⚡ Quick Reference

Register   : /register [name]  →  /code <CODE>
Add exp    : /aexp it:item am:amount [dt:date] [rc:record]
Edit exp   : /eexp sid:SID [it:] [am:] [dt:]
Delete exp : /dexp SID
View      : /vrexp today|thismonth|YYYY-MM|dt:d|dt1:s dt2:e|range:N [rc:name]
PDF       : /etpdf <same ranges>
Records   : /records  |  /addrecord <name>  |  /delrecord <name>
Account   : /editaccountname [name]
Billing    : /subscribe  |  /mysubscription

Date Range Shortcuts

today

thismonth

last7

YYYY-MM

Ready to track your expenses in Telegram?

Open the EzyTracker Bot