Chapter 01
What Is This App?
The short answer: it's your toolkit for visiting schools, counting students, and sending deals to Bayo for approval — all from your phone.
The Edu-BLOOM Agent App is a mobile web application for field agents. You use it when you visit a school, speak to the Principal, and want to sign them up to the Edu-BLOOM Premium platform. Everything from scanning the school signboard to submitting the deal is done inside this one app.
The app lives at agent.edubloom.com.ng and works like a normal website, but it can be added to your home screen so it opens like an installed app — no Play Store or App Store needed.
📷
Signboard Scan
Point your camera at the school sign — name, address, LGA and state fill in automatically.
📋
Register Counter
Photograph the class register or paste student names. The AI counts students for you.
💳
Ledger Scan
Photograph the school fees ledger page by page. AI extracts who has paid and who hasn't.
✨
Premium Plans
Select the right plan based on student count. All plans are now full Premium.
📊
Show Principal
A full-screen pitch screen — school name, headcount, and plan — to show the Principal before submitting.
💰
20% Commission
Every approved deal earns you 20% of the term fee, paid to your registered bank account.
Important: This is the live production app. Deals you submit here go directly to Bayo's portal and affect real schools. Always verify everything on a real device before closing an interaction.
Chapter 02
Logging In
Login uses your WhatsApp phone number — no password, no email.
Open the app at agent.edubloom.com.ng. You will see the Edu-BLOOM Agent login screen with two tabs at the top: Login and New Agent?
1
Make sure the Login tab is selected
It is selected by default (shown in blue). Tap it if not.
2
Enter your WhatsApp number
Type your number in international format — start with 234, then your number without the leading 0. For example: 2348012345678
3
Tap ▶ Login
Or press Enter on your keyboard. The app looks up your number in the system.
4
You are in
Your name and a green "Online" indicator appear at the top. The main tabs (Home, New Deal, Deals, Earnings) are now visible at the bottom.
Not finding your number? It means Bayo has not yet added you as an agent, or the number you typed doesn't match the one registered. Contact Bayo on WhatsApp: +234 814 507 3941
Chapter 03
New Agent Registration
If you are not yet registered, you can apply directly inside the app. Bayo reviews and approves you from his portal.
On the login screen, tap the New Agent? tab. A registration form will appear. Fill it in completely — all three sections are required.
Section 1 · Identity
1
Tap the photo circle to take your photo
A clear face photo is required for identity verification. Tap the camera circle or the "📸 Take / Upload Photo" button. You can use your front camera or gallery.
2
Enter your Full Name
As it appears on your bank account — this is what will go on your ID card.
3
Enter your WhatsApp Number
Local format is fine here (e.g. 08012345678). The app will convert it automatically.
4
Select the State you will cover
Choose the state where you will be visiting schools. All 36 states and FCT are listed.
Section 2 · Bank Account for Commission
Your 20% commission on every approved deal is paid directly into this account. Fill in all three bank fields accurately.
5
Select your Bank Name
Choose from all major Nigerian banks — Access, GTBank, UBA, Zenith, Opay, Kuda, Moniepoint, and more.
6
Enter your 10-digit Account Number (NUBAN)
Must be exactly 10 digits. Numbers only.
7
Enter your Account Name
Type it exactly as it appears on your bank statement.
Section 3 · How Did You Hear About Us?
Type how you found out about Edu-BLOOM — e.g. "Friend referral", "NAPPS event", "Social media". This field is optional but helpful for Bayo.
8
Tap 📨 Submit Request
Your request is saved directly into Bayo's portal. He gets a WhatsApp alert as backup. A green confirmation message will appear — you can close the app after this.
What happens next? Bayo reviews your request in the portal, approves it, and an Edu-BLOOM Agent ID Card is automatically generated with your photo. He will contact you on WhatsApp within 24 hours.
Chapter 04
Dashboard Overview
After login, the main app has four tabs at the bottom. Here's what each one does.
🏠
Home
Your quick summary — total deals submitted, approved deals, pending deals, and total commission earned at a glance.
➕
New Deal
The main work area. Everything for visiting a school — signboard scan, register counter, ledger scan, and deal submission — is here.
📄
Deals
A list of every deal you have submitted. Shows status: pending (yellow), approved (green), or rejected (red).
💰
Earnings
A detailed ledger of your commission payments — which deals earned what, and the running total.
The header bar at the top shows your name, a coloured dot for your connection status (green = online, red = offline), and a sync indicator when data is being saved.
Chapter 05
Section 1 — Scan School Signboard
Photograph the school signboard and the app fills in the school name, address, LGA, and state automatically.
This is the first thing to do when you arrive at a school. Tap the 📸 Scan School Signboard button at the top of the New Deal screen.
1
Point your camera at the signboard
The full board should be visible and the text should be legible. Good lighting helps a lot — avoid harsh shadows across the text.
2
Take the photo
Tap the shutter button. You can also upload a photo from your gallery if you already took one.
3
Wait a few seconds
The app sends the photo to the AI engine. You will see a "Reading signboard…" status message. This usually takes 3–8 seconds.
4
Review and correct the filled fields
School Name, Address, LGA, and State are auto-filled from the signboard text. Tap any field to correct it if the AI made a mistake.
OCR Cascade: The app tries three AI engines in order until one succeeds.
AariNAT OCR
→
Groq Vision
→
HuggingFace
→
OCR.space
If all fail (very rare), fill in the school details manually — the form fields are always editable.
Chapter 06
Section 2 — Smart Register Counter
Count the school's students accurately — by photographing the register, or by pasting a list of names.
The Smart Register Counter lets you find out exactly how many students are enrolled, which determines the Premium Plan tier and your commission. There are two ways to use it.
Option A — Photograph the Register
1
Tap "📷 Scan Register Photo"
Your camera opens. Photograph the class register pages — multiple photos are supported, one per page.
2
Hold the phone steady over the page
Good light and a straight angle give the best results. The app will warn you if the image is too blurry to read.
3
Wait for the count to appear
The AI reads only student NAMES from the register (not fees or marks). The total count is shown below, and the correct plan tier is highlighted automatically.
Option B — Paste Names (CSV or plain text)
1
Tap the text / paste area
You can paste a list of student names separated by commas, new lines, or as a CSV file from another source.
2
Tap Count
The app parses the names and gives you a total count instantly — no AI needed for this method.
Important: This section counts students for tier selection only. It does NOT extract fees or payment status — that is what the Financial Ledger Scan (Section 3) is for.
Chapter 07
Section 3 — Financial Ledger Scan
Photograph the school fees ledger to see who has paid, who hasn't, and the outstanding fee total — class by class.
This is the most powerful feature of the app. A school's fees ledger lists every student alongside their payment status and amounts. Scanning it lets you show the Principal exactly how much money is outstanding — making your pitch far stronger.
What the app reads from the ledger: Student name · Payment status (PAID, PARTIAL, or UNCLEAR) · Term fees · Balance outstanding. It processes multiple pages at once and groups results by class.
Scanning the Ledger
1
Tap "📷 Add Ledger Page"
Photograph one page of the fees ledger. You can add as many pages as needed — the app processes them all together.
2
Keep each page straight and well-lit
The app automatically corrects for slight angles (perspective correction) and removes blur, but extreme angles will reduce accuracy. Aim for a flat, overhead shot.
3
Tap "📖 Read All Pages"
The app processes every page one by one through the AI cascade. A live feed shows progress page by page. Pages with many students may take 10–15 seconds each.
4
Review the grouped results
Results are organised by class group. Each group shows total students, paid count, and outstanding amount. Any pages that failed to read are flagged — tap "Retry Failed Pages" to try again.
UNCLEAR status: When the AI cannot confidently read a student's payment status (e.g. handwriting is smudged), it marks them as UNCLEAR. These students are not counted as owing — only confirmed unpaid students appear in the outstanding total. This protects you from showing a falsely high figure to the Principal.
Chapter 08
School Details Form
After scanning, review and complete the school information before selecting a plan.
If you used the Signboard Scan in Section 1, most of these fields will already be filled in. Check them and correct anything that is wrong — the AI is accurate but not perfect.
1
School Name
Auto-filled from the signboard scan. Edit if needed — use the full official name.
2
Address
The physical address of the school. Auto-filled from signboard if available.
3
LGA
Local Government Area. Auto-filled from signboard scan.
4
State
Auto-filled from signboard scan. Select from the dropdown if not detected.
5
Principal's Phone Number
The school contact number. This is what Edu-BLOOM will use to send login credentials after approval.
Chapter 09
Premium Plans & Pricing
All Edu-BLOOM plans are now Premium. Select the plan that matches the school's student count.
As of August 2026, Edu-BLOOM offers one product: the ✨ Premium Experience. The plan you select is determined purely by how many students the school has — the price scales with size.
| Plan |
Student Count |
Term Fee |
Your Commission |
| ✨ Premium 1–50 |
1 – 50 students |
₦15,000 |
₦3,000 |
| ✨ Premium 51–100 |
51 – 100 students |
₦30,000 |
₦6,000 |
| ✨ Premium 101–200 |
101 – 200 students |
₦52,500 |
₦10,500 |
| ✨ Premium 201–350 |
201 – 350 students |
₦82,500 |
₦16,500 |
| ✨ Premium 351+ |
351+ students |
₦112,500 |
₦22,500 |
How to select: Tap the plan card that matches the count from your register scan. The card turns blue with a checkmark when selected. Your commission preview updates instantly below the selection.
Commission: 20% of every term fee, paid directly to your registered bank account after Bayo approves the deal. No re-typing needed — the deal is ready to activate from the moment it is approved.
Chapter 10
Show Principal Panel
A full-screen pitch screen you show the Principal before submitting the deal.
Once you have filled in the school details, counted the students, and selected a plan, tap the "Show Principal" button. This opens a clean, full-screen panel designed to be turned toward the Principal and shown on your phone.
The panel displays:
→
School name and location
Confirms to the Principal that the information captured is correct.
→
Total student headcount
From your register scan — shows the Principal you have a real figure, not a guess.
→
Outstanding fees (if ledger was scanned)
Class-by-class breakdown of how much money the school is owed. This is the strongest part of your pitch — the Principal can see the real figure instantly.
→
Selected Premium Plan
Shows "✨ Premium Plan Selected" with the plan tier and term fee.
→
The Edu-BLOOM slogan
"GIVE YOUR SCHOOL THE PREMIUM EXPERIENCE" — a strong close for the conversation.
After the Principal agrees, tap Close on the Show Principal panel to return to the deal form and submit.
Chapter 11
Submitting a Deal
The final step — sending the completed deal to Bayo's portal for approval.
Once everything is filled in — school details, student count, plan selected, and the Principal has seen the pitch — you are ready to submit.
1
Double-check all fields
School name, address, LGA, state, Principal's phone number, and selected plan. Everything in the deal is what Bayo will use to set up the school account.
2
Tap "Submit Deal"
The deal is sent to Firestore (the database) and appears immediately in Bayo's portal as a pending deal.
3
Wait for the confirmation
A green confirmation message appears with your deal reference number. The deal also appears in your Deals tab with a "Pending" badge.
4
Bayo reviews and approves
Once approved, the deal badge turns green and the commission appears in your Earnings tab. The school receives their login credentials via WhatsApp.
No re-typing needed. Everything captured by the scans and form goes directly into the deal. The school gets the full Premium Experience from day one.
Chapter 12
My Deals
Track every deal you have submitted and see its current status.
Tap the Deals tab at the bottom to see your full deal history. Each deal is shown as a card with the school name, date submitted, plan, and a coloured status chip.
🟡
Pending
The deal has been submitted and is waiting for Bayo to review and approve it.
🟢
Approved
Bayo has approved the deal. The school is now active on Edu-BLOOM and your commission has been recorded.
🔴
Rejected
The deal was rejected. Bayo may contact you on WhatsApp to explain. Rejected deals are shown at 60% opacity.
The list updates in real time — if Bayo approves a deal while you are looking at this screen, the badge will change from yellow to green automatically.
Chapter 13
My Earnings
A full record of every commission payment against your name.
Tap the Earnings tab to see your ledger. This shows every deal that has earned you a commission, with the deal name, term fee, your percentage, and the amount owed or paid.
The top of the screen shows summary stats:
💰
Total Earned
Sum of all commission payments recorded against your account to date.
⏳
Pending
Commission on deals that are approved but not yet paid out to your bank account.
✅
Paid Out
Commission that has already been transferred to your registered bank account.
Commission rate: 20% on every approved deal, calculated from the term fee of the selected plan. This is set by Bayo in the portal and cannot be changed from the agent app.
Chapter 14
Tips & Troubleshooting
Common issues and how to fix them quickly in the field.
📵 The app says "Firebase permission error" when I log in
This is a server-side issue, not your fault. Contact Bayo immediately — the Firestore security rules may need to be updated. Nothing you do on your phone will fix this.
📷 The signboard scan came back with the wrong name or address
The AI is accurate but not perfect on poorly lit or distant signs. Simply tap the field and correct it manually — the form is always editable regardless of what the scan found.
⏳ The OCR is taking very long or showing "Rate limit"
The AI engines have usage limits. When one is full, the app automatically waits and tries the next one in the cascade. Do not close the app — just wait. It will complete on its own.
📖 Some ledger pages say "Failed" in the results
This can happen with very blurry, dark, or heavily tilted photos. Tap "Retry Failed Pages" — the app retries only the failed pages, not the ones that already worked. If it fails again, retake the photo of that specific page in better light.
🔢 The page counter on the ledger shows "6/5" or wrong numbers
This was a known display bug — it has been fixed as of July 2026. If you see it, clear your browser cache (Settings → Clear browsing data) and reload the app to get the latest version.
🎨 The app looks light/pastel instead of dark navy
A stale cached version is loading. Clear site data for agent.edubloom.com.ng in your browser settings, then reload. The dark navy theme is correct.
📜 The New Agent registration page won't scroll back up
This has been fixed (August 17, 2026). Clear your browser cache or use incognito mode to force the updated stylesheet to load — the page will scroll freely in both directions.
📤 I submitted a deal but it's not showing up in Bayo's portal
If you were offline when you submitted, the deal may be queued for sync. Wait until you are back on a good connection — the app will sync automatically. If you had a signal when submitting and still cannot see it, contact Bayo directly.
💰 My commission figure looks wrong or is missing
Commission is recorded by Bayo's portal when he approves a deal. If the deal is still "Pending" it will not yet show in Earnings. If it is "Approved" and the figure is missing, contact Bayo on +234 814 507 3941.
Best Practices in the Field
💡
Scan the signboard first, always
It fills in all the school details in one shot. Starting with the scan saves you from typing a long school name manually.
💡
Ask to see the fees ledger
Principals who see the outstanding fees figure are much more likely to sign up. Ask politely — it's a simple record they keep at the school.
💡
Use Show Principal before submitting
Let the Principal confirm all the details are correct before you submit. This avoids rejection due to wrong school information.
💡
Stay on a good network during submission
The deal submission writes directly to the database. A dropped connection mid-submit can create a stuck deal. Wait for the green confirmation before leaving the school.