1. Overview
This guide is for the account owner or IT admin responsible for setting up AskVAVA for your company. Whether you have five employees or five hundred, the steps here will get you from a blank account to a fully configured workspace.
Who this is for
Business owners, IT admins, and anyone given the Owner or Admin role
What you'll answer
What do I do in the first hour? How do I invite my team? Which plan do I need?
What you'll have
Org created, team invited, roles assigned, and subscription confirmed
No technical expertise required
AskVAVA is designed for business users. You don't need to configure servers, manage databases, or write code. Everything in this guide is point-and-click.
2. First-Hour Setup
Follow these steps in order when you first create your account. The whole process takes under 30 minutes.
- 1
Sign up at askvava.com and verify your email
Check your inbox for a verification link. You must click it before you can continue.
- 2
Create your organisation
Enter your company name and country. This creates your multi-tenant workspace — all data stays within it.
- 3
Upload your company logo
Your logo appears on invoices, payslips, and financial reports. PNG or SVG recommended, minimum 200×200px.
- 4
Fill in basic company info
Add your registered address, GST registration number (if applicable), and financial year end (FYE). These populate PDF documents automatically.
- 5
Choose a starter plan
Starter is free — no credit card required. You can upgrade at any time from Settings → Billing.
- 6
Invite your first team member
Go to Settings → Members → Invite. See Section 3 for the full invite walkthrough.
FYE matters for compliance deadlines
Your financial year end determines when AGM and Annual Return deadlines are calculated. Set it accurately — you can change it later, but it will shift all auto-calculated deadlines.
3. Inviting Your Team
/dashboard/settings/membersAll team members are managed from Settings → Members. You can invite as many people as your plan allows.
- 1
Go to Settings → Members → Invite
Click the Invite Member button in the top-right corner.
- 2
Enter the email address and select a role
Choose from Owner, Admin, Supervisor, Finance, or Member. See Section 4 for a role breakdown.
- 3
Optionally assign to a department
Departmental assignment affects document visibility and roster scheduling.
- 4
Click Send Invite
AskVAVA sends an invitation email from noreply@askvava.com.
- 5
User receives email, clicks link, sets password, and joins your org
They land directly in your organisation's dashboard with the role you assigned.
Resending invites
Click the ... menu next to a pending invite and select Resend. Invites expire after 7 days.
Correcting mistakes
You can change a member's role or department at any time from the Members page. Click the member row to open their profile, then edit the role or department field.
4. Roles & Permissions
AskVAVA uses five built-in system roles. Every permission in the platform maps to one or more of these roles — there is no need to configure individual permissions unless you are on a Core Business plan with custom roles.
| Role | What They Can Do |
|---|---|
| Owner | Everything — org settings, billing, all modules, member management, and org deletion |
| Admin | Everything except billing and org deletion |
| Supervisor | Full admin minus org settings — HR, projects, documents, roster, claims, and more |
| Finance | Invoices, payroll, claims, accounting, and financial reports only |
| Member | View-only for most things; can submit leave requests and expense claims |
Supervisor vs Admin
Supervisor is designed for team leads who need full operational control — HR, scheduling, documents — but shouldn't be able to change org-wide settings like billing or company details. Use it for department heads and line managers.
Finance role
Finance is scoped exclusively to financial data. Assign it to bookkeepers or accountants who need full access to invoices, payroll, and reports but should not see employee records, HR workflows, or org settings.
Finance role for external bookkeepers
The Finance role is designed for external bookkeepers or accountants. They can access all financial data without seeing employee records or HR workflows.
There are 30+ granular permissions across resources. Custom role configuration is available on the Core Business plan — contact support to enable it.
5. Departments & Employment Categories
Departments are a foundational concept in AskVAVA. They affect payroll grouping, document visibility, and roster scheduling simultaneously — so it's worth setting them up correctly before adding employees.
Why departments matter
- Payroll grouping — run payroll for a single department or all at once
- Document visibility — the Department tier restricts document access to members of the same department
- Roster scheduling — departments define which employees are shown in the weekly roster planner
- Reporting — filter financial and HR reports by department
Department hierarchy
Create top-level departments (e.g. Operations, Finance, Sales) with optional sub-departments beneath them (e.g. Operations → Logistics, Operations → Fulfilment). There is no depth limit.
- Go to Settings → Departments → Add Department
- To create a sub-department, select a parent when creating it
- Rename or archive departments at any time — archiving hides them from dropdowns but retains historical data
Employment categories
Supported categories: Full-time, Part-time, Contract, Internship. Categories affect:
- Leave entitlement rules — e.g. interns may not accrue annual leave
- Payroll calculations — part-time and contract workers may have different statutory contribution rules
- CPF/EPF eligibility — full-time vs contract distinction matters for statutory contributions
Where to assign employees
Assign employees to departments from the Employees Hub (Team → Employees). Select the employee, edit their profile, and update the Department and Employment Category fields. You can bulk-reassign from the employees list view.
6. Subscription & Billing
AskVAVA has three plans. You can start on Starter for free and upgrade at any time with immediate effect.
| Plan | Price | Users | Docs / FAQs | Queries / mo |
|---|---|---|---|---|
| Core Starter | Free | 3 | 100 | 50 |
| Core Solo | S$29/mo | 1 | 1,000 | 500 |
| Core Team | S$79/mo | 10 | 5,000 | 2,500 |
| Core Business | S$149/mo | 25 | 25,000 | 10,000 |
Upgrading your plan
Go to Settings → Billing → Upgrade. You will be redirected to a Stripe checkout page. Upgrade takes effect immediately after payment confirmation.
Usage limits
When you reach a plan cap — for users, documents, or queries — new creation is blocked with an upgrade prompt. Existing data is never deleted when you hit a cap. Downgrading may hide records from view, but they are not removed.
Stripe customer portal
Manage your payment card, download past invoices, or cancel your subscription from Settings → Billing → Manage Subscription. This opens the Stripe customer portal in a new tab.
7. Integrations / Connected Apps
/dashboard/settings/integrationsConnect AskVAVA to your existing tools from Settings → Connected Apps. All connections use OAuth — no API keys to manage manually.
Accounting Sync
Two-way sync with Xero and QuickBooks. Invoices, bills, and journal entries flow in both directions — changes in AskVAVA appear in your accounting platform and vice versa.
- Sync invoices from AskVAVA to Xero automatically on approval
- Pull in supplier bills from QuickBooks for matching in AskVAVA
- Journal entries created in AskVAVA can be pushed to your accounting platform at month end
Payment Gateways
Accept payments from customers via HitPay or Stripe Connect. Payment links are embedded in invoices automatically once connected.
- HitPay supports PayNow, credit cards, and BNPL in Singapore
- Stripe Connect supports global card payments and local payment methods
- Payments received are marked against the invoice automatically
E-Commerce
Connect Shopify or WooCommerce to automatically convert orders into AskVAVA invoices.
- New orders in your store appear as draft invoices in AskVAVA within minutes
- Customer records are created or matched automatically
- Useful for reconciling e-commerce revenue in your accounting module
Connection flow
Settings → Connected Apps → click Connect next to the service → authorize via OAuth in the pop-up → return to AskVAVA.
Troubleshooting sync issues
If a sync stops working, click Reconnect next to the service. This refreshes the OAuth token. Most sync failures are caused by an expired token — reconnecting resolves them.
8. AI Import
/dashboard/ai-importAI Import lets you bulk-load data from CSV, Excel, or OFX files. The AI maps your column headers to system fields automatically — you review and confirm before anything is saved.
Employees
Bulk add or update employee records
FAQs
Bulk add knowledge base entries
Customers
Import CRM contacts
Journal Entries
Load historical bookkeeping data
Bank Transactions
Import from bank statement export
Formats
CSV, Excel (.xlsx), OFX
- 1
Select the import type and upload your file
Choose from the supported import targets above. Drag and drop or click to browse.
- 2
AI maps your column headers to system fields
AskVAVA reads your headers and suggests the best field match. Review each mapping and correct any mismatches.
- 3
Preview the first 10 rows before committing
Check that values look correct — dates, currencies, and names are shown as they will be imported.
- 4
Click Import — large files process in the background
You will receive a notification when the import is complete. Errors are listed row-by-row for correction.
Clean your data first
Remove blank header rows and ensure date columns use a consistent format (YYYY-MM-DD or DD/MM/YYYY). AI Import handles most variations, but inconsistent formats in the same column cause row-level failures.
9. Audit Trail
Available on Core Team and Core Business plans. Every create, update, and delete operation across all modules is logged — who did it, what changed, and when.
What is logged
All CRUD operations across employees, payroll, invoices, documents, settings, and more. Each entry shows the user, action type (created / updated / deleted), timestamp, and the before/after values where applicable.
Searching the audit log
Filter by user, action type, date range, or resource type. Useful for investigations — e.g. finding out who changed a payroll setting or deleted a document.
Retention policy
12 months of audit history on Core Team. Unlimited retention on Core Business.
Common use case
A payroll figure looks wrong and you need to know who changed it. Open the audit trail, filter by resource type “Payroll” and the relevant date range — the exact change and the user who made it will appear.
10. Documents & FAQs — Org-Wide Knowledge
Documents and FAQs feed the AskVAVA AI chat bot. The more relevant content you upload, the more accurate and org-specific the bot's answers become.
Document uploads
Upload PDFs, Word documents, and plain text files. Each document is processed through RAG (retrieval-augmented generation) — split into chunks, embedded, and stored in your org's vector index.
- HR policies, employee handbooks, SOPs, and process guides all work well
- Large documents (100+ pages) are supported but take slightly longer to process
- Re-uploading a document with the same name replaces the previous version
FAQ entries
Structured question-and-answer pairs. Ideal for policy questions, process guides, and HR rules where you want a precise, consistent answer.
- Examples: “How do I apply for annual leave?”, “What is our work-from-home policy?”
- FAQs are searched first before documents — keep answers concise and direct
- Bulk import FAQs from CSV using AI Import
Visibility tiers
| Tier | Who can see it |
|---|---|
| Public | All employees in your org (including via employee portal) |
| Department | Members of the same department as the uploader |
| Role | Members with the same role or above |
| Personal | The uploader only |
Regulatory documents are pre-loaded
Regulatory documents (MOM guidelines, TAFEP circulars) are pre-loaded by AskVAVA and available to all orgs automatically — you don't need to upload them.
11. Smart Extract
Smart Extract uses AI to read a PDF and pull out structured fields automatically. Drag a document onto the Smart Extract area and it surfaces the data for you to review before posting.
Vendor bills
Supplier, amount, GST, due date
Invoices
Customer, line items, totals
Contracts
Parties, dates, key terms
Bank statements
Transaction list for reconciliation
- 1
Drag a PDF onto the Smart Extract area
Or click to browse. Supported: PDF only. Max 20MB per file.
- 2
AI extracts structured fields
Processing takes 5–15 seconds depending on document length and complexity.
- 3
Review the extracted data
All fields are shown for confirmation. Edit any incorrect values before proceeding.
- 4
Post to the appropriate module
For vendor bills, this creates a bill in your accounting module. For invoices, it creates a draft invoice. Nothing is saved until you confirm.
Cost note
Smart Extract consumes AI tokens per page processed. It is available on all paid plans (Core Solo and above). Core Starter plan does not include Smart Extract.
12. Security & Compliance
AskVAVA is built with enterprise-grade security defaults. Here are the key settings you can configure as an admin.
MFA enforcement
Org owners can require all members to enable two-factor authentication. Go to Settings → Security → Require MFA. Once enabled, users who have not set up MFA will be prompted on their next login before accessing the dashboard.
Session management
View all active sessions for your account from your profile settings. Revoke any suspicious session immediately — the user is logged out within seconds.
Data residency
All organisation data is stored on Supabase's Singapore region. No data leaves the Singapore jurisdiction unless you explicitly export it.
GDPR / PDPA compliance
Employee data can be exported or deleted on request to comply with PDPA subject access requests. Contact support@askvava.com for a full data export or deletion request. AskVAVA processes data as a data processor on behalf of your organisation.
Row-level security
Every database table in AskVAVA is protected by row-level security (RLS). Members can only ever read and write data that belongs to their own organisation — cross-org data access is structurally impossible.
13. Troubleshooting
Common setup issues and how to resolve them.
Can't see a module
Some modules — including SECT (corporate secretary), Roster, and advanced reporting — require specific subscription plans or feature flags.
- Check your current plan under Settings → Billing — confirm it includes the module you expect
- If you recently upgraded, try a hard refresh (Ctrl/Cmd + Shift + R) to clear the cached plan state
- Some modules are enabled per-org by the AskVAVA team — contact support@askvava.com if you believe you have access but the module is not visible
Invites not delivered
If a team member says they didn't receive an invitation email:
- Ask them to check their spam or junk folder — invite emails come from noreply@askvava.com
- Resend the invite from Settings → Members → click ... next to the pending invite → Resend
- Verify the email address is spelled correctly — a typo creates a phantom pending invite
- Invites expire after 7 days — if it's been longer than that, delete and re-send
Bot not responding on WhatsApp
If an employee's WhatsApp messages to the bot are being ignored or returning errors:
- Check that the employee's phone number is set in the Employees Hub — go to Team → Employees → open the employee record → verify the Phone field is populated
- Phone numbers must be in international format: +65xxxxxxxx for Singapore, +60xxxxxxxx for Malaysia, and so on
- The phone field on the employee record takes priority over the whatsapp_phone_numbers table — always set it there first
- If the number looks correct but the bot still doesn't respond, contact support with the employee's phone number and the time of the failed message
Ready to set up your organisation?
Start free — no credit card required. Upgrade when you're ready.
Get started free