Vela Finance documentation
Everything the assistant can do today, and how to ask for it. If something is not on this page, it is not built yet.
Getting started
Vela Finance is a finance assistant that lives inside WhatsApp. There is no app to install and no dashboard to learn: you send a message, the assistant reads it and writes the entry into your ledger. Text, voice notes and photos of receipts all work, in English, Portuguese and Spanish.
Start the conversation
Open the chat with the button below, or save the number and send any message. The first message you send starts onboarding — there is no command to remember.
Onboarding, step by step
Onboarding is five short questions. The assistant remembers where you stopped, so you can answer at your own pace and pick it up later.
- Full name — the assistant asks who you are and uses that name in later replies.
- Email address — checked for a valid format. If it does not look like an email, you are asked again.
- Language — guessed from your phone number. Tap Keep to confirm it, or Change to pick English, Português or Español.
- Multi-currency — answer yes or no to track in more than one currency. Tap the button or just type the word.
- Bank statements — optional. Forward a PDF or CSV statement from the last month, or reply Skip.
- Done — the assistant confirms you are set up and lists everything it can do.
Your first transaction
Write what you spent the way you would tell a friend. An amount and a short description are enough; the assistant fills in the category, the account and today's date, then replies with the entry and the new balance.
Spent 45 euros on dinner with the card
🍽️ Dinner 45.00 EUR · Dining 💼 Card: −45.00 EUR
Recording transactions
Every entry starts as an ordinary WhatsApp message. There is no syntax to learn — the assistant reads the message and only asks when something essential is missing.
Plain text
Type it however you like: “spent 45 euros on dinner”, “paid 120 for electricity”, “got 2000 salary”. The amount and a short description are the only required parts; name a date, an account or a currency and those are used instead of the defaults.
Voice notes
Record a voice note and send it. It is transcribed in the background and handled exactly like text — the reply is the saved entry, not the transcript.
Receipt photos
Photograph the receipt. The total, the merchant and the date are read off the image and become one entry. Add a caption if you want to correct or add anything.
Expenses, income and transfers
Three kinds of entry are supported. Expenses and income move one account. A transfer moves money between two accounts you own — name both and each balance is updated in the same step, without counting as spending.
Categories
A category is assigned automatically from the description, matched against the categories in your workspace in whichever language you wrote. Name a category yourself and it wins; one that does not exist yet is created. Every workspace starts with these:
- Groceries
- Dining
- Transport
- Housing
- Utilities
- Health
- Shopping
- Entertainment
- Travel
- Education
- Other
- Salary
- Transfer In
Reports and queries
Ask a question in plain language and the assistant runs the report. There are two shapes: a grouped summary, and an itemized list.
Periods
Every report covers one period. The built-in ones are today, this week, this month and last month; anything else is read out of your message as a custom range.
- Today
- This week
- This month
- Last month
- Selected period
Grouping
A summary can be grouped by category, by member, by currency or by account. Each line shows its share of the total as a percentage, and the report ends with expenses, income and the net for the period.
- category
- member
- currency
- account
Filters
Narrow a report to one category, one account, or both — for example “how much did I spend on groceries this month” or “show last month for Chase Checking”.
Itemized lists
Ask to see the transactions themselves instead of totals and you get them one by one, with the same period, category and account filters. The list is capped at the 20 most recent entries.
Balances
Ask for your balance to see every active account and the total. The balance of the account you touched is also printed on the confirmation after each entry, so you rarely have to ask.
Accounts and statements
An account is where the money sits: a bank, a card, a wallet of cash. Every entry belongs to one, and each account keeps its own running balance and its own currency.
Creating and editing accounts
You can list your accounts, create one, update its details, or archive one you no longer use. Archiving keeps the history and takes the account out of the list. Mention a bank or card the assistant does not know yet and it offers to create it. Only the last four digits of a card or account number are ever stored.
Account types
- Checking — an everyday bank account.
- Savings — money set aside.
- Credit — a card, where the balance is what you owe.
- Cash — notes and coins you hold.
- Investment — a brokerage or fund account.
- Loan — a debt you are paying down.
Importing a statement
Forward a statement as a PDF or CSV and every movement on it is imported into one account in a single step. The header is read to work out which account it belongs to, and the account is created if it does not exist yet. Lines that cannot be read are reported rather than guessed at.
What is read from the header
Before importing, the assistant extracts the bank or card issuer, the account or card numbers printed on the statement, and the period it covers, then confirms them back to you.
Duplicate detection
The same movement often arrives twice — you photographed the receipt and later uploaded the card statement, or two statements overlap by a few days. Duplicates are matched across every account in the workspace, not only the one being imported, and the repeated lines are skipped and counted in the reply. Both halves of a transfer between your own accounts are recognised as one movement.
Reconciling a balance
Tell the assistant the balance printed on your statement and it compares it with the balance it calculated. If they agree it says so and changes nothing; if they do not, it books a single adjustment entry so the account matches the bank.
No bank connection
To be plain about it: Vela Finance does not connect to your bank. There is no Open Banking link, no card feed and no credentials to hand over. Everything in your ledger is there because you sent a message or forwarded a statement.
Multi-currency
Every workspace has one base currency — the one your totals are reported in. Each account can hold a different currency, and any single entry can be in any currency.
Base currency and account currency
The base currency is set when the workspace is created, guessed from your phone number. An account in another currency keeps its own balance in that currency and is converted into the base currency for totals and reports.
Exchange rates
Rates come from Frankfurter, which publishes the European Central Bank reference rates. The rate applied is the one published for the date of the transaction, not today's rate, and it is stored on the entry — so a report of last year still uses last year's rates. Rates are cached, and a weekend or holiday resolves back to the last published business day.
When a rate is unavailable
If the rate service cannot be reached and nothing usable is cached, the entry is kept in its own currency and left out of the converted totals, and the assistant tells you that in the reply. A rate is never invented.
Exact amounts
Amounts are stored as whole minor units — cents, not fractions of a cent — so nothing drifts through rounding. The number of decimals follows the currency: the yen has none, most currencies have two, the Kuwaiti dinar has three.
Shared workspaces
A workspace is one ledger. It can be just you, a household, or a company. Everyone writes into it from their own WhatsApp number, and you can belong to several and switch between them.
What you can do
Create a workspace, invite someone by phone number, list the members with their roles, and switch which workspace your messages go to. Anything you send lands in the workspace you are currently switched to.
Roles
- Owner — everything an admin can do, plus changing roles and deleting the workspace. The person who created the workspace.
- Admin — records entries, runs reports and invites new members.
- Member — records entries and runs reports, but cannot invite anyone.
- Viewer — read-only. Reports and lists yes, recording or editing no.
How an invite works
An invite creates a pending membership for the phone number you gave, and the invited person gets a message in the language guessed from their country code. Nothing is shared yet. The membership activates by itself the first time they write to the assistant, and that workspace becomes their active one.
Roles
Two things are not available from the chat yet: removing a member, and changing someone's role afterwards. Everyone invited joins as a member; the person who created the workspace is its owner.
Help and support
Two ways to get unstuck, both from the same chat.
Ask for help
Send “help” and the assistant lists what it can do, in your language. It is the same summary you get at the end of onboarding.
Talk to a person
Ask to contact support and your message is emailed to the team at support@usevelafinance.com. Someone reads it and gets back to you.
Privacy, limits and data
A few limits are worth knowing about, most of them imposed by WhatsApp itself.
The 24-hour window
WhatsApp only lets a business send free-form messages for 24 hours after your last message. Inside that window the assistant replies normally. Outside it, anything we send you — a scheduled summary, for example — has to use a message template approved in advance by Meta, which is why those read more formally. Writing back reopens the window.
Rate limit
Up to 15 messages per 60 seconds from one phone number. Go over it and the assistant asks you to slow down; the limit clears within the minute.
File size
Voice notes, photos and statements are accepted up to 20 MB. Anything larger is rejected before it is downloaded — send a smaller photo, or split a long statement.
Your data
What is collected, who processes it and how to have it deleted are all written down. See the Privacy Policy, the Terms of Service and the Data Removal page.
Command reference
Write it in your own words — these are examples, not commands. Everything below works the same in English, Portuguese and Spanish.
| What you send | What happens |
|---|---|
| Spent 45 euros on dinner | Records a 45 EUR expense, categorized as Dining. |
| Received 3200 salary today | Records income of 3200 in your base currency, categorized as Salary. |
| Moved 500 from Checking to Savings | Records a transfer and updates both balances, without counting as spending. |
| How much did I spend this month? | A summary for this month grouped by category, with each share as a percentage. |
| Show last month by account | The same summary for last month, grouped by account instead. |
| List my transactions this week | The entries themselves for this week, up to the 20 most recent. |
| What accounts do I have? | Lists every active account with its balance. |
| Add my Nubank card ending 1234 | Creates a credit account and remembers it for later entries. |
| My Checking statement says 1,240.55 | Compares that with the calculated balance and books an adjustment if they differ. |
| Invite +351912345678 | Sends an invite; the membership activates on their first message. |
| Switch to the Acme workspace | Points your next messages at that ledger. |
| Help | Lists everything the assistant can do. |
| I want to talk to a human | Emails your message to support, and someone replies to you. |