JiwaAI
Blog
โ†All posts
product-design
whatsapp
southeast-asia
accessibility
onboarding

WhatsApp-First Onboarding: Meeting Users Where They Already Are

Jiwa AI Teamยท

The Browser Is a Detour

Here's what happens when you tell a warung owner in Surabaya to "visit our website and sign up": nothing. Not because they can't โ€” they have smartphones, they have data plans, they run their entire business from their phone. But the browser is a foreign country. WhatsApp is home.

The numbers in Southeast Asia are unambiguous. Indonesia alone has over 100 million WhatsApp users. For small business owners, WhatsApp isn't just a messaging app โ€” it's their CRM, their customer service desk, their order management system, and often their primary interface with the internet. Asking them to leave that context to fill out a web form is asking them to leave their comfort zone for yours.

We'd been delivering content through WhatsApp for months โ€” post previews, approval workflows, publishing notifications. The review commands were already there: SETUJU_SEMUA to approve all posts, REVIEW to go through them one by one, STATUS to check where things stand. But onboarding itself still required opening a browser, navigating to a dashboard, and connecting Instagram through a web form.

That gap was the real barrier to adoption. Not price, not features, not AI quality. Just friction.

Two Words That Change Everything

The entire onboarding flow now starts with a single message. Type /daftar in Indonesian, or /onboard in English. That's it.

The system responds with a welcome message and an Instagram authorization link. The user taps the link, connects their Instagram account in the browser (this step requires Instagram's OAuth โ€” we can't avoid the browser entirely), and lands on a simple confirmation page: "Instagram terhubung. Cek WhatsApp Anda."

Then they close the browser and go back to WhatsApp. Within minutes, the full pipeline has run โ€” brand analysis, influencer matching, content calendar, caption generation, image creation โ€” and the results arrive as WhatsApp messages. Post previews with images. Approval commands. Everything they need to review and publish their first content, without ever visiting a dashboard.

The Architecture of Zero Friction

Making this work required solving a few non-obvious problems.

The first was identity. Our existing onboarding required an authenticated web session โ€” a logged-in user clicking buttons on a dashboard. WhatsApp users don't have web sessions. They have phone numbers.

We solve this with automatic user creation. When the Instagram OAuth callback fires with a WhatsApp-originated state parameter, the system creates a user account tied to that phone number. If they later log into the web dashboard using WhatsApp OTP, the same account matches. No duplicate identities, no migration, no "link your accounts" flow. The phone number is the identity.

The second problem was the OAuth redirect. Instagram's authorization flow is web-based โ€” there's no way around loading a browser page. But we minimized the time spent there. The OAuth link is pre-configured with the user's phone number and language encoded in the state parameter. After authorization, the callback page shows a single sentence of confirmation and tells them to check WhatsApp. The browser is a five-second detour, not a destination.

The third was pipeline orchestration. The full onboarding pipeline takes two to five minutes โ€” scraping, analyzing, generating. In a web flow, you can show a progress bar. In WhatsApp, you send an acknowledgment ("Kami sedang menganalisis bisnis Anda...") and deliver results when they're ready. Fire and forget, with error notifications if something goes wrong.

Why Not Just a Link to the Dashboard?

We could have taken the simpler approach: respond to /daftar with a link to the web dashboard. Let WhatsApp be the entry point but keep the actual onboarding on the web.

We tried something better. The Instagram connection is the onboarding. Once we have their Instagram data, we have everything we need โ€” their products, their aesthetic, their audience, their content history. The AI analyzes all of it without the user filling out a single form field.

This is the key insight: for businesses that already have an Instagram presence, their Instagram account IS their business profile. We don't need them to type their business name, describe their products, or upload photos. We extract all of that from the Instagram data they already maintain.

The Language Question

Southeast Asia is multilingual by default. A business owner in Jakarta might speak Bahasa Indonesia at work, Javanese at home, and switch to English for international customers. Our WhatsApp commands reflect this reality.

/daftar triggers the Indonesian flow. /onboard triggers English. The language choice propagates through the entire pipeline โ€” brand analysis, caption generation, approval commands, status messages. It's not translation; it's localization. The Indonesian flow uses Bahasa Indonesia idioms and formatting conventions. The English flow is direct and international.

This matters because language isn't just communication โ€” it's trust. A small business owner who receives marketing content in their language, with their cultural references, from a system that spoke to them in their language from the first interaction, is a business owner who trusts the product.

What We Learned From Delivery

After months of delivering content via WhatsApp, we had data on what works and what doesn't in this medium.

Image previews with truncated captions get reviewed. Long text messages get skipped. Interactive buttons (approve/reject per post) get higher engagement than text commands, but text commands are essential for older devices that don't support buttons.

The approval workflow โ€” SETUJU_SEMUA, TOLAK_SEMUA, REVIEW โ€” had already proven itself. Businesses that use WhatsApp approval publish their content faster than those who approve through the dashboard. Not because WhatsApp is technically faster, but because it's where they already are. There's no context switch. No "I'll do that later when I'm at my laptop." The content arrives, they review it between customer messages, and they approve.

Adding onboarding to the same channel completes the loop. Discovery, setup, content review, publishing โ€” all from the same app, the same conversation thread.

Maximum Accessibility as Strategy

This isn't a feature. It's a strategic bet.

Every AI product in the content space is building dashboards. Beautiful, feature-rich dashboards with analytics, calendars, drag-and-drop editors, and real-time previews. Those dashboards serve a specific user: the marketing manager at a mid-size company who has a laptop open all day.

That's not our user. Our user is the owner of a clothing store in Bandung who takes product photos between serving customers, whose "computer" is a phone, and whose digital workflow is WhatsApp conversations. For this user, every feature that requires a browser is a feature that doesn't exist.

Maximum accessibility means meeting users where they already are, not where you wish they were. For millions of small businesses across Southeast Asia, that place is WhatsApp. The businesses that can type two words and have AI-generated marketing content delivered to their phone โ€” those are the businesses we want to serve.

The dashboard isn't going away. It's there for users who want it, for detailed editing, for analytics, for the features that genuinely need a screen larger than a phone. But the critical path โ€” getting started, reviewing content, approving posts โ€” that path runs through WhatsApp now.

Because the best product isn't the one with the most features. It's the one people actually use.