AskVAVA
Admin Guide

Setting Up AskVAVA for Your Organisation

Everything a business owner or IT admin needs to configure AskVAVA from scratch — org creation, team invites, roles, billing, and integrations — all in one place.

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. 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. 2

    Create your organisation

    Enter your company name and country. This creates your multi-tenant workspace — all data stays within it.

  3. 3

    Upload your company logo

    Your logo appears on invoices, payslips, and financial reports. PNG or SVG recommended, minimum 200×200px.

  4. 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. 5

    Choose a starter plan

    Starter is free — no credit card required. You can upgrade at any time from Settings → Billing.

  6. 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/members

All team members are managed from Settings → Members. You can invite as many people as your plan allows.

  1. 1

    Go to Settings → Members → Invite

    Click the Invite Member button in the top-right corner.

  2. 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. 3

    Optionally assign to a department

    Departmental assignment affects document visibility and roster scheduling.

  4. 4

    Click Send Invite

    AskVAVA sends an invitation email from noreply@askvava.com.

  5. 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.

RoleWhat They Can Do
OwnerEverything — org settings, billing, all modules, member management, and org deletion
AdminEverything except billing and org deletion
SupervisorFull admin minus org settings — HR, projects, documents, roster, claims, and more
FinanceInvoices, payroll, claims, accounting, and financial reports only
MemberView-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.

Context

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
Structure

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
HR Config

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.

PlanPriceUsersDocs / FAQsQueries / mo
Core StarterFree310050
Core SoloS$29/mo11,000500
Core TeamS$79/mo105,0002,500
Core BusinessS$149/mo2525,00010,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/integrations

Connect AskVAVA to your existing tools from Settings → Connected Apps. All connections use OAuth — no API keys to manage manually.

Finance

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
Finance

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
Sales

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-import

AI 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. 1

    Select the import type and upload your file

    Choose from the supported import targets above. Drag and drop or click to browse.

  2. 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. 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. 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.

Docs

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
FAQs

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
Access Control

Visibility tiers

TierWho can see it
PublicAll employees in your org (including via employee portal)
DepartmentMembers of the same department as the uploader
RoleMembers with the same role or above
PersonalThe 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. 1

    Drag a PDF onto the Smart Extract area

    Or click to browse. Supported: PDF only. Max 20MB per file.

  2. 2

    AI extracts structured fields

    Processing takes 5–15 seconds depending on document length and complexity.

  3. 3

    Review the extracted data

    All fields are shown for confirmation. Edit any incorrect values before proceeding.

  4. 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.

Access

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
Onboarding

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
WhatsApp

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