Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.quickei.io/llms.txt

Use this file to discover all available pages before exploring further.

The Quickei WhatsApp Bot enables conversational banking — users can check balances, send money, exchange currencies, and view history directly from WhatsApp.

Features

Balance Check

Check wallet balances across all currencies by sending “balance” or “solde”.

Send Money

Transfer funds with a guided step-by-step flow including PIN verification.

Currency Exchange

Exchange between currencies with real-time rates — “change” or “exchange”.

Transaction History

View recent transactions by type — send “history” or “historique”.

Commands

The bot understands natural language in English and French:
CommandAlias (FR)Description
balancesolde, balCheck wallet balances
sendenvoyer, transfererSend money
exchangechange, echangerExchange currencies
historyhistoriqueView transactions
helpaide, menu, hi, bonjourShow help menu
cancelannuler, stopCancel current action
englishanglaisSwitch to English
francaisfrançaisSwitch to French
Unlike the Telegram bot, WhatsApp users are automatically identified by their phone number — no account linking step is needed if their Quickei account uses the same phone number.

Send Money Flow

User: send
Bot:  Who do you want to send money to? (email, phone, or @username)
User: +33612345678
Bot:  How much do you want to send?
User: 25
Bot:  Select currency: [EUR] [USD] [XOF]
User: EUR
Bot:  Send 25.00 EUR to Marie Dupont?
      [✓ Confirm] [✗ Cancel]
User: ✓ Confirm
Bot:  Enter your transaction PIN
User: ****
Bot:  ✓ Transfer complete! 25.00 EUR sent to Marie Dupont

Currency Exchange Flow

User: exchange
Bot:  Which currency do you want to exchange FROM?
      [EUR] [USD] [XOF] [GBP]
User: EUR
Bot:  Which currency do you want to exchange TO?
      [USD] [XOF] [GBP]
User: USD
Bot:  How much EUR do you want to exchange?
User: 100
Bot:  Exchange 100.00 EUR → 108.50 USD (rate: 1.085)?
      [✓ Confirm] [✗ Cancel]
User: ✓ Confirm
Bot:  Enter your PIN
User: ****
Bot:  ✓ Exchange complete! 100.00 EUR → 108.50 USD

Technical Setup

The WhatsApp integration uses the Meta Business API (WhatsApp Cloud API).

Prerequisites

RequirementDescription
Meta Business AccountWith WhatsApp Business API access
WhatsApp Business PhoneA verified phone number
Webhook URLhttps://quickei.io/whatsapp/webhook
Verify TokenConfigured in Quickei admin (BasicSettings.sms_config.meta_verify_token)

Webhook Configuration

Verification endpoint (Meta sends a GET request to verify):
GET https://quickei.io/whatsapp/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=CHALLENGE
Message endpoint (incoming messages):
POST https://quickei.io/whatsapp/webhook

Signature Verification

All incoming webhooks are verified using the X-Hub-Signature header (SHA256):
$expected = hash_hmac('sha256', $payload, $app_secret);
if (!hash_equals($expected, $signature)) {
    abort(403, 'Invalid signature');
}

Security

Phone-Based Auth

Users are identified by their WhatsApp phone number, matched against their Quickei account.

PIN Verification

All financial operations require the user’s transaction PIN before execution.

Rate Limiting

30 messages per minute per phone number to prevent abuse.

Message Deduplication

Each message ID is tracked to prevent duplicate processing of the same message.

Supported Message Types

TypeSupport
Text messagesFull support
Button repliesFull support (interactive buttons)
List repliesFull support (list selections)
Images / Video / AudioNot supported (returns helpful message)