Welcome, Team
Your customer engagement operations at a glance.
Customer enquiry lifecycle
Automated triage with human-in-the-loop controls.Recent activity
Operational journey
Explore lifecycle stages across communications and automations.Unified Shared Inbox & Activity Timeline (§4.2)
Omnichannel customer communications across WhatsApp, Email, and Voice, atomic ownership claiming, internal note segregation, and unified cross-channel timeline.
Email Inbox, AI Drafts & Deliverability (§4.4)
Shared admissions mailbox, grounded AI drafts with human approval gating, outbox send intents, and RFC 8058 unsubscribe ledger.
Model Telemetry & Observability
Execution traces, prompt grounding verification, guardrail audits, token spend, and latency telemetry.
Approved AI Tasks & Guardrails
Control task availability, confidence cutoffs, and mandatory human review gates.Human Review & Approval Queue
Invariant: AI drafts cannot send without human approval.Interactive Task Sandbox & Guardrail Tester
Simulate inputs against tenant policy, PII redaction, and grounding rules.Redacted Execution Traces & Telemetry
PII-masked audit records for compliance and cost auditing.🛡️ AI Grounding & Fact AST Validation Engine (R07 / CR-05)
Deterministic AST ActiveValidation Decision Report
GROUNDEDRecent Grounding Evaluations & Audit Trail
Persistent audit of checked claims, blocked violations, and fallback actions.◒ Lead & Enquiry Management (§4.1)
Multi-channel enquiry capture, atomic owner assignment, qualification scoring, and opportunity conversion.
Enquiries Directory
Showing 0 records🏢 Contacts & B2B Accounts (§3.2)
Multi-tenant account hierarchies, multi-identity contact resolution, and deduplication review queues.
Organisation Directory
Select an account to view linked personnel and rolesSelect an Account
Choose an organisation on the leftLinked Personnel & Roles (§3.2):
Deduplication Review Queue
Identical numbers or emails do not force destructive merge; review cases here💼 Sales Pipeline & Opportunities
Track opportunities across qualification, consultation, proposal, and deal closing.
Product & Service Knowledge (§4.7)
Maintain versioned offerings, facts, and approved documents. Withdrawn or unapproved knowledge is strictly prevented from being used in AI responses.
Knowledge Repository
Live items for tenant| Knowledge Item | Category | Offering | Version | Effective Period | Status | Actions |
|---|---|---|---|---|---|---|
| Loading knowledge repository... | ||||||
Grounding Policy & Guardrails (§4.7)
AI answers can ONLY cite items in
published state within valid effective dates.
Outdated or unverified information is instantly blocked from all customer-facing AI pipelines.
If no approved fact matches the customer query, the AI states uncertainty and opens a human callback task instead of guessing.
Tenant Offerings
Support Tickets (§5.1)
Track customer inquiries, LMS issues, SLA response targets, and audit-logged priority escalations. Internal staff notes are never exposed to customers.
Support Ticket Queue
Customer issues with SLA ownership and audit history| Ticket # / Subject | Contact | Category | Priority | Status | Queue / Owner | Created | Actions |
|---|---|---|---|---|---|---|---|
| Loading support tickets... | |||||||
Support Invariants & Policies (§5.1)
Internal staff discussion is flagged
is_internal=true and completely stripped from all customer views and public APIs.
Supervisory escalations require a stated business reason and are permanently preserved in the ticket audit trail.
Conversation & Lifecycle Guardrails
Resolving or closing a ticket never automatically pauses, closes, or alters customer WhatsApp/Email conversations.
Tickets, notes, and assignment queues are isolated by Postgres RLS with zero cross-tenant leakage.
Appointment Booking (§5.2)
Book course consultations, demos and interviews with concurrency-controlled host availability, timezone preservation and reminder tracking.
Scheduled Appointments
Host calendars, attendance statuses, and reminder automation| Date & Time | Appointment / Type | Contact | Host | Location / Link | Status | Attendance | Actions |
|---|---|---|---|---|---|---|---|
| Loading scheduled appointments... | |||||||
Automated Reminders Queue (§5.2)
Channel-specific delivery, suppression checks, and offset-based dispatching| Scheduled For | Appointment | Contact | Channel | Offset | Status | Sent At |
|---|---|---|---|---|---|---|
| No reminders recorded yet. | ||||||
Booking & Scheduling Invariants (§5.2)
Protected by PostgreSQL
btree_gist exclusion constraints over tstzrange(start_time, end_time) for each host.
Timezones are stored alongside UTC timestamps to eliminate offset ambiguity across regions.
Reminders & Attendance Guardrails
Cancelling an appointment automatically revokes all pending reminders without sending unscheduled outbound spam.
Attendance is explicitly tracked and verified separately from scheduling and payment records.
Payments & Commerce (§5.4)
Generate payment links, issue customer invoices, reconcile provider webhooks, and maintain immutable double-entry financial transaction ledgers.
| Created | Reference | Customer / Contact | Title & Description | Amount | Expires | Status | Actions |
|---|---|---|---|---|---|---|---|
| Loading payment links... | |||||||
Payments & CRM State Invariants (§4.4, §5.2)
A lead status of "Won" or a closed opportunity is a business state and does NOT automatically create a payment record. Payments originate strictly from verified provider transactions.
An appointment or consultation booking is not proof of attendance or payment.
Reconciliation & Ledger Guardrails (§5.4, §6.2)
Provider webhook verification and reconciliation is mandatory before an invoice is marked paid. Reconciliation failures create manual reviews instead of confirmed invoices.
All settlements, fees, and refunds are posted to a double-entry ledger with cryptographic idempotency keys preventing duplicate financial credits.
Tenant & User Administration (§3.1)
Multi-branch locations, departmental teams, membership roles, typed custom fields, and data retention policies.
• Session Rotation: Membership role updates immediately invalidate and rotate session privileges with audit logging.
• Audit-Bound Elevation: Platform support elevation is temporary (max 24h), purpose-bound, and strictly audited.
• Row-Level Security: Every tenant-owned branch, team, user, and custom field enforces database-level RLS.
Branch Locations & Operating Timezones
Manage regional branches, operational timezones, and business hours| Branch Name | Code | Timezone | Address / Contact | Primary | Status | Actions |
|---|---|---|---|---|---|---|
| Loading branches... | ||||||
Tasks & Follow-up automation
Ensure every enquiry or case has an accountable owner, scheduled next action, and timezone-aware execution.
Data Analytics enquiry sequence
Active · Version 3 · 41 leads currently enrolledTasks & Follow-ups Queue (§4.6)
Real-time accountable tasks with timezone enforcement, escalation tracking, and audit logFinal send eligibility check
Simulate workflow branch
Use these controls to demonstrate safe automation behavior.
Human handover
Complex, sensitive, uncertain, or human-requested cases are routed with full context.
Case #HO-1048 · Rahul Verma
Consultancy enquiry · Created 13 minutes agoAI-generated staff summary
Rahul is interested in the AI implementation consultancy for a 45-person organisation. He requested a custom price and a consultation this week. The assistant supplied the published service overview, captured his email and requested callback time, then paused automation because pricing requires human confirmation.
Consultancy queue
2 open casesWorkflow Automation (§5.3)
Controlled business workflows — versioned rules, idempotency gates, consent suppression blocks, and safe retries.
Configured Workflow Rules
Live registered rules with version history| Rule & Description | Trigger Type | Version | Safety Gates | Actions Configured | Status | Actions |
|---|---|---|---|---|---|---|
| Loading workflow rules... | ||||||
Recent Executions (Idempotency Audit)
Deduped by(tenant_id, rule_id, event_id)
| Time & Rule | Event / Contact | Outcome |
|---|---|---|
| Loading executions... | ||
Automation Failures & Safe Retries
Failures are isolated and retryable without side-effectsIntegration Hub (§5.4)
Connect external CRMs, calendars, payment providers, and webhooks with provider-scoped IDs, kill switches, and idempotent synchronization.
Supported Connectors & Active Links
Recent Sync Operations
Bounded, idempotent synchronization runs| Provider & Time | Direction | Status | Records |
|---|---|---|---|
| Loading sync jobs... | |||
Failures & Reconciliation
Isolated failures retryable safely without duplicate recordsWhatsApp & Channels Setup
Direct WhatsApp QR pairing and Email admissions channel setup for AddOn Training.
Channels & Integrations
Manage multi-channel connectivity across WhatsApp and Email admissions mailboxes.
Email Channel
Shared Admissions MailboxFull bidirectional MIME parser with auto-reply loop detection, RFC 8058 one-click unsubscribe, and unrestricted 24-hr service window.
WhatsApp Live Chatbot
Scan QR Code to Pair InstantlyInstant link via WhatsApp Web. Scan this QR code with your phone to start receiving prospect inquiries directly in Veloqic.
Developer: Manual Channel Registration
Model routing policy
Analytics & Reporting (§4.9)
Measure response times, pipeline conversion, staff workloads, channel delivery states, and costs. Reports strictly distinguish measured data from cost estimates.
Channel Performance & Delivery Completeness
Rule: Accepted is distinct from delivered; unknown provider outcomes are visible, never omitted.| Channel | Accepted | Sent | Delivered | Failed | Unknown | Measured Units | Estimated Cost |
|---|---|---|---|---|---|---|---|
| Loading channel metrics... | |||||||
Reporting Invariants & Safety (§4.9)
Provider-accepted messages (e.g. Meta HTTP 200 or SMTP queue) are NOT reported as delivered until explicit receipt events arrive.
Telephony disconnections or carrier timeouts with unknown outcomes are explicitly tracked, never silently omitted.
Call dispositions (e.g., "Interested") and Won stage changes never invent payments. Realized revenues represent formal closed-won deals only.
Workload & Queue Health
Sales Pipeline Conversion
Report Export Audit Trail (§4.9)
Exports are strictly scoped to the tenant, cryptographically checksummed, and recorded for compliance.| Report Type | Format | Exported By | Records | SHA-256 Checksum | Status | Exported At |
|---|---|---|---|---|---|---|
| Loading export history... | ||||||
💳 SaaS Billing & Entitlements (§6.2)
Tenant plans, feature entitlement gates, idempotent usage metering, and payment reconciliation.
Available Platform Subscription Plans
Veloqic subscription billing is separate from tenant customer billingActive Plan Entitlements
Strict enforcement across UI, API, worker, and integrations.Entitlement Gates & Metering Sandbox
Verify §6.2 acceptance invariants and suspension blocks.Simulate an action (e.g. Telephony Outbound, Custom Workflows) to test plan feature gating.
Record a metered usage event with fixed idempotency key to verify deduplication.
Suspended tenant cannot initiate optional billable sends/calls, but retains security/privacy access.
Invoices & Payment Reconciliation Ledger
Invariant: Payment success is not confirmed until provider reconciliation settles it. Failures trigger review.Channel Management & Inbound Webhooks (§3.2)
Unified multi-tenant channel provisioning, webhook secret rotation, diagnostic telemetry, and quarantined event triage.
Trust & security
Production controls designed for customer data, AI safety, and accountable automation.
Tenant isolation
Every contact, lead, knowledge item, workflow, credential, file, trace, and audit event is scoped to the tenant workspace.
Role-based access
Owners, admins, agents, marketing users, and viewers receive only the permissions required for their role.
Encrypted credentials
Platform and BYOK API keys are encrypted, never displayed after saving, and excluded from logs and AI prompts.
Consent and opt-out
Follow-up messages require policy checks. “Stop” immediately sets Do Not Contact and cancels applicable queued actions.
Published knowledge only
AI can use only tenant-approved, published, effective knowledge. Missing facts trigger safe fallback or handover.
Audit and observability
Important user, AI, workflow, consent, and data events are traceable with redaction and retention controls.
Privacy operations
Operational readiness
Veloqic Tenant Administrator Guide
Complete step-by-step handbook for configuring channels, knowledge, AI guardrails, email mailboxes, WhatsApp QR pairing, and daily operations.
1. Quick-Start Checklist (First 15 Minutes)
Follow these 5 steps in order to take your tenant workspace live safely.
- Verify Branding & AI Persona: Open WhatsApp & Channels Setup to confirm your brand name, colors, support email, and AI advisor persona instructions.
- Publish Approved Knowledge & Courses: Open Course Knowledge Base and review your courses/offerings and published policy articles. Only articles in Published state are used by AI.
- Pair Your WhatsApp Number: Open WhatsApp & Channels Setup, scan the live QR code with your business phone (WhatsApp ➔ Linked Devices ➔ Link a Device), and verify the status turns green (Connected).
- Connect Your Email Mailbox: Open Email Inbox & Drafts ➔ Mailbox Setup, select your mail provider (Gmail, Zoho, Microsoft 365, or Custom SMTP/IMAP), enter your App Password, click Save & Connect, and confirm both SMTP & IMAP tests pass.
- Run a Live End-to-End Test: Send a test WhatsApp message from a personal phone or click Sync Inbox Now / Simulate Inbound Email, verify the thread appears in Shared Inbox / Email Inbox, and test claiming and replying as staff.
2. Overview Dashboard & Enquiry Lifecycle
Understand your executive dashboard metrics and automated workflow stages.
Every customer enquiry moves through 5 controlled stages: 1. Inbound Enquiry (WhatsApp, Email, or Web Portal) ➔ 2. Automated Triage (intent detection, opt-out check, sensitivity check) ➔ 3. Grounded Knowledge Lookup (only published facts) ➔ 4. CRM Lead Update (contact & interest captured) ➔ 5. Next Action (automated reply, scheduled follow-up, or human handover).
3. Shared Inbox, Conversation Modes & Human Handover
Manage live WhatsApp, Email, and Portal conversations with strict AI-to-human controls.
Conversation Control Modes
- Bot Mode: AI automatically replies using published knowledge and policy rules.
- Human Mode: Automation is paused immediately. Only staff members can send replies until a staff member explicitly switches back to Bot Mode.
- Paused Mode: All outbound messages are halted (e.g., pending review or customer opt-out).
Automatic Safety Triggers
- STOP / Opt-Out: If a customer replies STOP, unsubscribe, opt out, or regional equivalents (e.g., बंद करो, Abmelden), Veloqic immediately blocks future automated messages and cancels queued follow-ups.
- Human Escalation: Asking for a human, custom discounts, refunds, or sensitive topics automatically opens a Handover Case and pauses the bot.
- Atomic Ownership (§4.1): Only one advisor owns an active enquiry at a time; handovers log an auditable timeline event.
4. Email Inbox, AI Draft Review & Mailbox Configuration (SMTP / IMAP)
Connect your own domain mailbox, sync real incoming emails, and send approved replies.
Step-by-Step: Connecting Your Tenant Mailbox
- Navigate to Email Inbox & Drafts ➔ ⚙️ Mailbox Setup.
- Click a Quick Preset (Gmail / Workspace, Zoho Mail, Microsoft 365, or Custom SMTP/IMAP) to auto-fill host & port settings.
- Enter your Mailbox Email Address (e.g.,
[email protected]), Sender Display Name, and your App Password. - Click 💾 Save & Connect Mailbox. Veloqic encrypts your credentials using tenant-isolated AES-256-GCM KMS encryption and automatically runs a live SMTP & IMAP login test.
- Click 🔄 Sync Inbox Now anytime to pull recent customer emails from your IMAP
INBOXdirectly into Threads & Messages (automatically deduplicated).
| Mail Provider | SMTP Host : Port | IMAP Host : Port | Authentication Requirement |
|---|---|---|---|
| Gmail / Google Workspace | smtp.gmail.com : 587 (STARTTLS) |
imap.gmail.com : 993 (SSL) |
Enable 2FA ➔ generate a 16-char App Password at myaccount.google.com/apppasswords |
| Zoho Mail (India / Global) | smtp.zoho.in : 465 (SSL) |
imap.zoho.in : 993 (SSL) |
Enable IMAP in Zoho Mail Settings ➔ use a Zoho App-Specific Password (use .com for US DC) |
| Microsoft 365 / Outlook | smtp.office365.com : 587 (STARTTLS) |
outlook.office365.com : 993 (SSL) |
Enable Authenticated SMTP & IMAP in M365 Admin Center |
| Amazon SES / Custom | email-smtp.<region>.amazonaws.com : 587 |
Optional (outbound-only supported) | Use SES SMTP credentials + verified sender domain (SPF/DKIM) |
5. WhatsApp Live Chatbot & QR Code Setup
Link your WhatsApp Business / personal number in seconds and control automated replies.
- Open WhatsApp & Channels Setup and wait for the card status badge to show Ready to Scan with a QR code.
- On your phone, open WhatsApp ➔ Settings (or ⋮ menu) ➔ Linked Devices ➔ Link a Device and scan the QR code.
- Within 5–10 seconds, the badge turns green (Connected) and displays your linked phone number. Your session is persisted across server restarts.
- Pausing AI Auto-Reply: Use the ⏸ Turn Off Auto-Reply / ▶ Turn On Auto-Reply toggle inside the connected card to pause automated replies while keeping your WhatsApp number linked and still logging incoming messages into Shared Inbox.
- Switching Numbers: Click Log Out / Unlink Number to disconnect the current WhatsApp session and generate a fresh QR code for a different phone.
6. Leads CRM & White-Labeled Public Enquiry Portal
Capture prospects from your website, social bio, or ads straight into your Veloqic CRM.
Every tenant automatically gets a branded, public-facing enquiry page that matches your workspace colors, logo, and course catalog:
- Share this link on your website ("Enquire Now"), Instagram/LinkedIn bio, or brochures — submissions automatically create a Contact + Enquiry + Timeline entry in your workspace.
- Inside Leads, filter prospects by stage (Exploring, Qualified, Enrolled), assign owners, and review full interaction history across WhatsApp & Email.
7. Course Knowledge Base & AI Anti-Hallucination Guardrails
Control exactly what your AI assistant is allowed to say to prospective customers.
Publishing Lifecycle
- Draft: Editable by your team; never visible to AI.
- Published: Approved source of truth; AI cites structured facts & versions directly from published items.
- Withdrawn (§4.7): Immediately blocks AI from citing outdated batches, fees, or discontinued courses.
Built-In Safety Guardrails
- No Unauthorized Discounts or Guarantees: Claims like "100% job guarantee" or invented fee discounts are automatically blocked by the grounding validator.
- Safe Fallback: When a customer asks a question not covered in published knowledge, AI acknowledges the limit and routes to a human advisor instead of guessing.
8. Workspace Branding, AI Persona & BYOK (Bring Your Own Key)
Customize your white-label identity and connect your preferred LLM provider.
- White-Label Branding: Configure your Brand Name, Portal Slug, Logo / Favicon, Primary & Accent Colors, and Support Email. Updates apply across your workspace and public enquiry portal.
- AI Persona & System Instructions: Define your assistant's tone, greeting style, and institutional rules (e.g., AddOn Admissions Advisor).
- BYOK (Bring Your Own Key): Connect your own Google Gemini or OpenAI API key. Keys are encrypted at rest with tenant-specific AES-256-GCM keys, masked after saving, and never exposed in logs or browser responses.
9. Security, Account Access & Troubleshooting FAQ
Best practices for keeping your tenant workspace secure and resolving common issues.
Click Sign Out in the top-right bar or bottom-left sidebar. Veloqic immediately revokes your session token on the server (so even a copied token stops working) and clears browser session storage.
Standard account passwords are blocked by Gmail and Zoho for SMTP/IMAP. Turn on 2-Step Verification on your email account, create a dedicated App Password, paste that into Mailbox Setup, and click Test Connection.
WhatsApp QR codes rotate automatically every ~20 seconds while on the WhatsApp & Channels Setup page. Wait 3 seconds for the fresh QR to appear. If it stays Offline for more than 1 minute, contact your platform administrator to verify the
whatsapp-bridge service is running.
Check the article's status in Course Knowledge Base — newly added items start in Draft mode. Click Publish so the AI grounding engine is authorized to cite it.
No. Every table in Veloqic enforces PostgreSQL Row-Level Security (RLS) scoped to your
tenant_id, and all mailbox & BYOK credentials are encrypted with a unique tenant-derived key.