πŸ“š Complete Platform Documentation

MOBOT AI Documentation

Comprehensive guide to Ghana's WhatsApp Fintech platform. Learn about system architecture, user flows, security protocols, and integration capabilities.

πŸ“‹ Table of Contents

πŸš€

Introduction

About MOBOT AI, vision, mission, and target market

πŸ—οΈ

System Architecture

Core components, security layers, and scalability

πŸ‘€

User Flow

Onboarding process, security setup, and account activation

πŸ”

KYC & Tier System

Verification requirements, tier limits, and upgrade flow

πŸ›‘οΈ

Security & AML

Authentication, risk monitoring, and compliance

πŸ”Œ

Integration Guide

API references, webhooks, and partner integrations

1. Introduction

1.1 About MOBOT AI

MOBOT AI is a Ghana-based WhatsApp Fintech platform designed to bring secure, seamless, and humanized financial experiences directly into users' chats. Powered by MOBOT Custom AI Model (trained on 67,687+ Ghana financial conversations), LLMs and Firebase, MOBOT transforms WhatsApp into a bank-grade intelligent assistant that understands Ghanaian local languages β€” including Akan, Ewe, Ga, and French β€” while providing users with personalized, smart financial interactions.

Through natural conversation, MOBOT enables users to:

  • Send and receive money in seconds
  • Pay bills, buy airtime/data
  • Schedule or track transactions
  • Withdraw cashless from ATMs
  • Receive statements and manage accounts securely

MOBOT isn't a bank β€” it partners with registered financial providers like Paystack, ExpressPay, Hubtel, and MTN to deliver all financial services through verified, regulated APIs.

1.2 Vision

To make financial access in Ghana as simple as chatting, enabling users to manage, transfer, and grow their money without leaving WhatsApp β€” in their own language, tone, and comfort.

1.3 Mission

To bridge the gap between technology and trust by offering a secure, user-friendly AI fintech assistant that empowers everyday Ghanaians to transact, save, and learn financial habits naturally through conversation.

1.4 Target Market

MOBOT primarily serves:

  • Ghanaian individuals and small businesses seeking easy mobile transactions
  • Rural and semi-urban users who prefer WhatsApp over traditional apps
  • Digital-first youth and professionals looking for modern, fast, and transparent financial tools
  • Multilingual users, through MOBOT's ability to understand local dialects

1.5 Platform Overview

MOBOT AI functions entirely within WhatsApp, using 360Dialog as the official WhatsApp Business API channel.

When users message "Hi MOBOT" or "Hello," the assistant:

  1. Welcomes them warmly with friendly emojis
  2. Starts onboarding within seconds
  3. Verifies identity via Full name, Telephone number, Ghana Card and PIN
  4. Creates a virtual account number for financial transactions
  5. Enables real-time services such as payments, transfers, and reports

Every interaction is powered by AI-driven habit learning, allowing MOBOT to understand each user's preferences, language, and transaction style over time β€” turning fintech into a daily, chat-based lifestyle experience.

1.2 Vision

To make financial access in Ghana as simple as chatting, enabling users to manage, transfer, and grow their money without leaving WhatsApp β€” in their own language, tone, and comfort.

1.3 Mission

To bridge the gap between technology and trust by offering a secure, user-friendly AI fintech assistant that empowers everyday Ghanaians to transact, save, and learn financial habits naturally through conversation.

1.4 Target Market

MOBOT primarily serves:

  • Ghanaian individuals and small businesses seeking easy mobile transactions
  • Rural and semi-urban users who prefer WhatsApp over traditional apps
  • Digital-first youth and professionals looking for modern, fast, and transparent financial tools
  • Multilingual users, through MOBOT's ability to understand local dialects

1.5 Platform Overview

MOBOT AI functions entirely within WhatsApp, using 360Dialog as the official WhatsApp Business API channel.

When users message "Hi MOBOT" or "Hello," the assistant:

  1. Welcomes them warmly with friendly emojis
  2. Starts onboarding within seconds
  3. Verifies identity via Full name, Telephone number, Ghana Card and PIN
  4. Creates a virtual account number for financial transactions
  5. Enables real-time services such as payments, transfers, and reports

Every interaction is powered by AI-driven habit learning, allowing MOBOT to understand each user's preferences, language, and transaction style over time β€” turning fintech into a daily, chat-based lifestyle experience.

2. System Architecture

2.1 Overview

The MOBOT ecosystem is built on a secure, cloud-native, and AI-powered architecture, combining the strengths of Firebase, Google Cloud, Cloudflare, and licensed Ghanaian fintech APIs.

At its intelligence core, MOBOT is powered by our custom-trained AI model, built specifically for Ghana's financial ecosystem. This proprietary model, trained on 67,687+ Ghana financial conversations, drives MOBOT's reasoning, personalization, and natural understanding of Ghanaian languages, with specialized support for 5 local languages and 187 Ghana-specific financial tokens.

This structure ensures:

  • Bank-grade security and encryption
  • 99.9% uptime and performance
  • Contextual and human-like conversations
  • Instant synchronization between users, the backend, and admin systems
  • Scalable AI services that evolve with user behavior

2.2 Core Components

Front-End Layer (User Interaction)

Platform: WhatsApp via the 360Dialog official API
Function: Provides the conversational interface for users to chat, transact, and get support
Capabilities: Understands Ghanaian local languages, supports buttons and quick replies, provides smart responses

AI & Middleware Layer

Powered by: MOBOT Custom AI Model (67,687+ Ghana financial conversations)
Function: Interprets user messages, understands intent, and generates intelligent replies
Capabilities: Learns user behavior, supports 5 Ghanaian languages, handles voice and text communication with 187 specialized financial tokens

Backend Layer

Powered by: Firebase on Google Cloud
Core Functions: Authentication, transaction verification, real-time data sync, notification delivery
Tools: Firestore Database, Firebase Cloud Functions, Firebase Hosting & Auth

2.3 Security & Network Layer

Cloudflare serves as MOBOT's security shield and content delivery network (CDN).

Responsibilities:

  • DDoS and intrusion protection
  • SSL/TLS encryption
  • Bot and spam filtering
  • Speed optimization across global access points

2.4 Payment & Service Integrations

Provider Integration Role Purpose in MOBOT Status
Paystack Payment Gateway Handles deposits, funding, and virtual account creation βœ… Active
ExpressPay Payment Aggregator Enables bank transfers and utility payments βœ… Active
Hubtel KYC & Business Services Verifies users, manages airtime/data purchases βœ… Active
MTN API Mobile Money Provider Handles Momo deposits, transfers, and withdrawals βœ… Active
360Dialog WhatsApp API Manages user communication and automation βœ… Active
Dojah KYC & AML Services Document verification, face matching, AML screening βœ… Active

3. User Flow

3.1 Overview

The MOBOT User Flow is designed to be simple, human, and fast β€” allowing anyone in Ghana to start using MOBOT directly from WhatsApp in just a few minutes.

MOBOT blends a friendly chat experience with a professional onboarding process powered by AI and Firebase verification.

3.2 Step-by-Step Onboarding

Step 1: First Interaction

When a new user sends "Hi MOBOT," the system responds with a warm, emoji-filled welcome message and an onboarding button labeled "Click here to start πŸš€"

Step 2: User Details Collection

MOBOT collects: Full Name, Telephone Number, Ghana Card Number, and optional Referral ID. These details are verified through Firebase and Hubtel APIs.

Step 3: Security Setup

Users create a 4-digit PIN or emoji-based PIN with confirmation. Security rules include 5 incorrect attempts β†’ 30-minute freeze, continued wrong attempts β†’ 1-hour freeze.

Step 4: Account Activation

MOBOT automatically assigns a Virtual Account Number and sends a welcome success message with features preview and virtual account details.

3.3 Security System Rules

  • 5 incorrect PIN attempts β†’ temporary 30-minute freeze
  • Continued wrong attempts β†’ 1-hour freeze
  • MOBOT reminds the user how many tries are left
  • Users can say "Forgot PIN" to trigger reset verification
  • PIN reset requires identity verification using security questions

4. KYC & Tier System

4.1 Overview

MOBOT applies a progressive KYC (Know Your Customer) and tiered verification system designed to ensure trust, compliance, and financial security. Each user tier determines the required verification level and corresponding transaction limits.

The system automatically upgrades users as they grow β€” ensuring frictionless onboarding and robust compliance for high-value users.

4.2 Tier Structure & Verification Requirements

MOBOT Tier Verification Requirements Daily Limit (β‚΅) Monthly Limit (β‚΅) Verification Partner
1️⃣ MOBOT Go
Basic KYC
βœ… Full Name
βœ… Telephone (OTP verified)
βœ… Ghana Card Number
βœ… 4-digit PIN
β‚΅5,000 β‚΅15,000 MOBOT + Hubtel / MTN
2️⃣ MOBOT Flex
Verified Identity
βœ… Ghana Card (Front & Back Upload)
βœ… Live Selfie (Face Match)
βœ… 3 Security Questions
βœ… Next of Kin
β‚΅10,000 β‚΅30,000 Dojah (ID & Face Match)
3️⃣ MOBOT Plus
Address Verification
βœ… Proof of Address
βœ… Address must match Ghana Card
βœ… Secondary Contact
βœ… GPS location capture
β‚΅20,000 β‚΅60,000 Dojah (OCR & Address)
4️⃣ MOBOT Gold
Financial Proof
βœ… 3-Month Bank/MoMo Statement
βœ… Occupation & Employer Details
βœ… Declared Monthly Income
βœ… Source of Funds
β‚΅50,000 β‚΅150,000 Dojah + MOBOT Compliance
5️⃣ MOBOT Ultimate
Enhanced AML
βœ… All previous documents
βœ… Short Video KYC
βœ… Enhanced AML/PEP Screening
βœ… Social Media Handle
β‚΅100,000 β‚΅500,000 Dojah AML + MOBOT Admin

4.3 Upgrade Flow Logic

  1. Every user begins at MOBOT Go (Tier 1) after completing basic KYC
  2. MOBOT automatically monitors both daily and monthly transaction limits
  3. When a user reaches the maximum limits, a system notification prompts them to upgrade
  4. Required verification documents are submitted securely and verified via Dojah APIs
  5. Once verification is approved, the user's tier and transaction limits are upgraded automatically

5. Security & AML

5.1 User Security & Authentication

Security is at the core of MOBOT's architecture. Every user action, from sign-in to transactions, is authenticated and verified through multiple layers β€” combining PIN-based control, device trust logic, and AI-driven anomaly detection.

Authentication Layers:

WhatsApp Account Authentication

The user's WhatsApp number is their unique identifier. No manual password required.

PIN Verification

Every user sets a 4–6 digit PIN (or emoji PIN) during onboarding. Required for transactions.

Session Token Validation

Each session uses a Firebase JWT token tied to the WhatsApp ID and device fingerprint.

AI Session Monitor

Detects login from unusual IP, device, or location. Flags risk and triggers re-verification.

5.2 AML & Risk Monitoring

MOBOT integrates a multi-layered Anti–Money Laundering (AML) and Risk Monitoring System designed to ensure compliance, detect suspicious activity, and protect both users and the platform from fraudulent or illegal financial behavior.

AML Risk Layers:

Layer Description Technology / Partner
Identity Screening Every verified user undergoes PEP & Sanctions check during KYC upgrade Dojah AML API
Transaction Behavior Monitoring AI system monitors transaction frequency, size, pattern, and geolocation anomalies MOBOT AI Engine + Cloudflare
Device & Geo-IP Tracking Monitors device fingerprints and IP locations for unusual activity Cloudflare + Firebase Analytics
Cross-platform Risk Analysis Evaluates interactions between users to identify coordinated movements MOBOT Risk Engine
Manual Review & Escalation Flagged accounts routed to Compliance Dashboard for human verification MOBOT Admin System

5.3 Data Protection & Privacy

MOBOT prioritizes data protection, privacy, and compliance at every system level. All user data is handled in accordance with the Ghana Data Protection Act (Act 843), Bank of Ghana E-Money Guidelines, and GDPR.

Data Protection Principles:

  • Lawful & Fair Use: Data collected only for verified financial, security, or compliance purposes
  • Transparency: Users always informed about what data is being collected and why
  • Purpose Limitation: Data never used for unrelated or external purposes
  • Data Minimization: Only necessary information collected
  • Accuracy: Users can request updates or corrections at any time
  • Storage Limitation: Non-critical data automatically deleted after operational purpose
  • Integrity & Confidentiality: Encryption, access controls, and AI monitoring ensure security

6. Integration Guide

6.1 API Reference Overview

MOBOT connects to a multi-provider ecosystem to deliver a unified fintech experience.

Provider / API Purpose Integration Status
Firebase Authentication, database, storage, session logic βœ… Active
Google Cloud Hosting, compute functions, analytics βœ… Active
Cloudflare Security, Zero Trust access, geo-IP protection βœ… Active
Paystack API Payment gateway for virtual accounts and transfers βœ… Active
Hubtel API Airtime, momo, and bill payments βœ… Active
ExpressPay API Payment redundancy (secondary provider) βœ… Active
MTN API Mobile money verification and withdrawal βœ… Active
Dojah API KYC, AML, document & face verification βœ… Active
WhatsApp Business API Main conversational interface βœ… Active
Future Integrations Flutterwave, Remitly, Wave, Visa Direct πŸ”œ Planned

6.2 System Flow Diagram

// MOBOT System Architecture Flow [ User (WhatsApp) ] ↓ [ Firebase Auth ] ↓ [ Core Engine (Cloud Functions) ] ↓ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” | Paystack API | Hubtel API | Dojah API | β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ↓ [ Firebase DB + Cloudflare Layer ] ↓ [ Admin Dashboard + Analytics ]

6.3 Fees & Product Growth Strategy

Transparent Fee Principle

MOBOT operates on a "Provider + Platform" model. Each user-visible fee always combines:

  1. Provider Fee β†’ paid to Paystack, Hubtel, MTN, or ExpressPay
  2. MOBOT Platform Fee β†’ our operational margin that covers infrastructure, security, and support

πŸ’¬ "What you see = what you pay."

Every transaction message displays both components clearly before confirmation.

Dynamic Fee Structure

Transaction Type Amount Range (GHS) Provider Fee (Avg.) MOBOT Fee (Go Tier) Total Fee Example
MoMo Transfer 1 – 99 0.50 0.20 0.70
100 – 499 1% 0.25% 1.25%
500 – 999 1% 0.20% β‰ˆ 1.20%
β‰₯ 1,000 7.50 flat 0.25% (β‰ˆ 2.50) β‰ˆ 10.00
Bank Transfer any 8.00 flat 0.25 – 0.50% β‰ˆ 8 – 10
Bills / Airtime 1 – 500 1.95% 0.25% β‰ˆ 2.2%
> 500 1.50% 0.20% β‰ˆ 1.7%
Internal MOBOT β†’ MOBOT any Free 0.20 flat 0.20
Incoming Deposit any Free Free Free

Free Monthly Quota & Rewards

To attract users without hurting profitability, MOBOT introduces a limited free-use system:

Tier Free Transfers / Month After Free Limit Extra Benefits
Go 2 Standard rate Intro bonus for new users
Flex 4 – 0.10% discount More MoMo options
Plus 6 – 0.20% discount 1 free bill payment
Gold 10 – 0.30% discount Priority support
Ultimate 20 external + unlimited internal – 0.50% discount Merchant analytics

Free quota resets automatically on the 1st of each month.

Product Growth Flywheel

πŸš€ Acquisition

Make It Effortless

  • WhatsApp-First UX: no app download, zero learning curve
  • Free Transfers: 2–4 per month = instant adoption trigger
  • Referrals: both parties get free transactions or cashback

⚑ Activation

First Success in Under 60 Seconds

  • Single onboarding flow (Full name + Ghana Card + Tel)
  • Auto-create virtual account via Paystack API
  • AI guide walks user through first MoMo transfer instantly

πŸ”„ Retention

Build Trust & Habit

  • Always show fee breakdown
  • Send weekly AI insights ("You saved GHS 3.40 this week")
  • Add micro-rewards & tier upgrades after usage milestones

πŸ’° Revenue

Profit without Pain

  • Earn margin after free quota
  • Tier subscriptions (Plus/Gold/Ultimate) for heavy users
  • Offer business accounts for SMEs (payroll & bulk payouts)

6.4 Contact Information

πŸ“ Head Office

Accra, Ghana

βœ‰οΈ Email

support@chatmobot.com

🌐 Website

https://chatmobot.com

πŸ“˜ Documentation

https://chatmobot.com/documentation