OzcenkLabs connects directly to your own WhatsApp Business account. This means messages flow to and from your number — not a shared pool — so customers see your business, your branding, and your verified profile.
Before you start
You'll need:
- A phone number you control that isn't already registered on a personal WhatsApp account. If it is, back up your chats and delete the personal account first — Meta can't move a number that's in active use elsewhere.
- Access to that number to receive a one-time verification code (SMS or voice).
- A Facebook account. Meta's embedded sign-up runs through Facebook login.
Step 1 — Open the connection screen
From the dashboard, go to Settings → WhatsApp Connection(URL: /dashboard/ayarlar/whatsapp-baglan). You'll see one of two states:
- Not Connected — a blue Connect WhatsApp button is visible.
- Connected — your linked number, WhatsApp Business Account ID, and connection date are shown, along with a Disconnect button.
Step 2 — Click Connect WhatsApp
Pressing the button opens a Meta-hosted popup. This is Meta's official embedded sign-up flow — your credentials and phone codes never touch OzcenkLabs servers. The popup walks you through:
- Logging in with your Facebook account.
- Selecting an existing Meta Business Portfolio or creating a new one. If you're a sole trader, create a new portfolio with your business name.
- Selecting an existing WhatsApp Business Account (WABA) or creating one. If this is your first WhatsApp Business setup, create a fresh WABA.
- Adding the phone number you'll use. Meta sends a 6-digit code to confirm you control it.
- Filling in your business display name, category, and description.
The Meta popup handles all of this. OzcenkLabs only receives the final identifiers (phone number ID, WABA ID, business ID) once you finish.
Step 3 — Wait for the success message
After the Meta popup closes, OzcenkLabs runs three steps automatically:
- Exchanges Meta's authorization code for an access token.
- Subscribes our app to your WABA — this is what lets us receive incoming messages.
- Registers your phone number with a 6-digit security PIN (stored encrypted).
When all three succeed, you'll see a green ✓ Connected card showing your number and WABA ID. The page reloads and you're ready to receive messages.
What happens to incoming messages
Every WhatsApp message a customer sends to your number now flows through:
- Meta's WhatsApp Cloud API → OzcenkLabs webhook.
- Your AI assistant generates a reply using your knowledge base and current conversation context.
- The reply goes back to the customer through your number.
Replies appear in Live Chats in real time. If a customer asks for a human or you flag the conversation, the AI hands off and you can take over from the dashboard.
Disconnecting
Press Disconnect on the connection page. This:
- Unsubscribes our app from your WABA (you keep the number and WABA).
- Clears all credentials from our database.
- Falls back to the Twilio provider for new conversations, if you still have one configured.
You can reconnect anytime with the same flow.
Troubleshooting
The popup says my number is already in use
The number is registered on a personal WhatsApp account. Open WhatsApp on the phone, back up chats, then go to Settings → Account → Delete my account. Wait a few minutes and try the embedded sign-up again.
I see "PIN mismatch"
The number was previously registered with a PIN you don't remember. Reset the PIN at business.facebook.com/wa/manage, then disconnect and reconnect from OzcenkLabs.
Connection works but no messages arrive
Send a test message to your number from a different phone. If nothing appears in Live Chats, check Settings → WhatsApp Connection — the green card should still show. If it doesn't, reconnect. If the issue persists, email hello@ozcenklabs.com with your WABA ID.
Security notes
- OzcenkLabs stores your access token encrypted at rest. Sensitive columns are revoked from the public Postgres role.
- The token only authorises sending and receiving messages on the WABA you connected. It can't access other Meta assets.
- You can revoke our access at any time directly from business.facebook.com → Settings → Apps, in addition to the in-app Disconnect button.
Next steps
- Upload your knowledge base so the AI can answer customer questions.
- Test the chatbot before sharing your number publicly.