How to put real businesses in Hargeisa on the map, step by step.
Goal: 20 real businesses on the map, each one checked by staff. The words are kept simple. Somali and Arabic screens are still English only.
Who does what
Person
Role needed
Does
Invite sender
Terratech editor or higher
Sends the invites
Business owner
Any Google account
Fills the form
Reviewer
Terratech reviewer or higher
Approves or rejects
Four-eyes rule: a reviewer cannot approve a business they created themselves.
Part 1Send an invite Editor
Open the web map and sign in.
Open the Account menu and tap Invite a business.The Account menu. Tap the ringed button.
Fill in: business name, phone number, a place note (for example "near Jamhuuriya Hotel"), and the language of the message.
Optional: put a pin on the shop.
Tap Make invitation.The form with made-up data. Tap the ringed button. The screen shows a link, a QR code and a Send on WhatsApp button. The code is shown only once. Copy the link now.
Tap Send on WhatsApp. WhatsApp opens with the message ready. Press send yourself. Send one at a time.The result. The phone number here is made up.
The invite list shows the state: Not sentSentOpenedRegisteredApprovedExpiredCancelled
A wrong invite? Tap Cancel invitation in the list.
Rules: an invite is valid for 30 days and works for one business only. 5 wrong tries block the link for 1 hour.
Part 2Add the business Owner
Open the link from WhatsApp (or scan the QR code).
Tap Sign in with Google.
The form is already filled with the name and phone. Check it.
Fill in: category, phone, WhatsApp, opening hours, short description, address note.
Put the pin on the exact shop door.
Add 1 to 5 photos (not required).
If a warning says a similar business is near, tap This is mine or Different place.
Tap Send for review. The state becomes Waiting for review. Save draft keeps it private: nobody else can see a draft.The owner form. The Send for review button stays at the bottom.
Later, open My businesses to see the state. If it is Rejected, the reason is shown. Fix it and submit again.
My businesses. The ringed label is the state.
Part 3Review Reviewer
Sign in, open Staff, then the Businesses tab.
Open a card. Check: name, category, phone, photos, pin on the map, and the list of near duplicates.A review card. The ringed box is Mark as verified.
Tap Approve. Tick Verified only if you have checked the business is real (call, visit or see the shop).
Or tap Reject and choose a reason: wrong place, duplicate, not a business, bad photo, wrong phone, other. Add a note. A reason is required.Quick reasons, the reason box, then Reject or Approve.
Hide removes an approved business from the public map. It can be shown again.
Part 4Check it is public
Open the web map. In Layers, tick Businesses. Important categories show from zoom 12, all from zoom 15.Layers. Tick Businesses.
Tap a pin. The popup shows Open page, Directions, Share, Call, WhatsApp.The pin popup. Tap the ringed button.
Open the page /b/<short id>. It must show the name, hours and photos. The phone number is only on the page buttons, not in the page source tags.The public page. The ringed buttons are Call and WhatsApp.
Share the link by WhatsApp and check the preview card.
Problems
Problem
What to do
The invite link says not found
It is wrong, used, expired, cancelled or blocked. Make a new invite.
The owner cannot sign in
Use a Google account. Try again in a normal browser, not inside WhatsApp.
Business not on the map
It is not approved yet, or Businesses is not ticked in Layers.
Wrong pin
The owner edits the business. The old version stays public until a reviewer approves the change.
Spam or wrong phone reported
Reports are on the review screen. Hide the business, then decide.
Pilot checklist
20 invites sent, state Sent.
At least 10 Registered.
All reviewed within 2 days.
5 businesses checked on a phone.
Owner notes: what was hard? (write them here)
Based on docs/BUSINESS-PILOT-GUIDE.md. Standards: WhatsApp click-to-chat (wa.me) for invites; Google sign-in (OpenID Connect).