Connect WhatsApp

Connect a WhatsApp Business number so messages from WhatsApp land in the same inbox and your chatbot answers them automatically — with the same handoff, skills and knowledge as the website widget.

Before you start

You need a Meta app (Business type) with the WhatsApp product added. From WhatsApp › API Setup you'll copy a Phone number ID, a WhatsApp Business Account ID, and an access token. One WhatsApp number connects per workspace.

1. Connect your number

Go to Sidebar › Integrations › WhatsApp and fill in Step 2:

• Phone number ID (required) — from Meta › WhatsApp › API Setup.
• WhatsApp Business Account ID (optional) — same page.
• Display number (optional) — the readable number shown in your inbox.
• Access token (required) — the 24-hour test token, or a permanent System User token with the whatsapp_business_messaging scope for production.
• Which agent answers WhatsApp? — the chatbot that replies.

Click Connect WhatsApp. MagizAI generates a verify token for you and marks the channel connected.

2. Point Meta's webhook at MagizAI

Step 3 shows your Callback URL and Verify token. In Meta, open WhatsApp › Configuration › Webhook › Edit and paste them:

• Callback URL: https://yourdomain.com/whatsapp/webhook
• Verify token: the string shown after you connect.
• Save (Meta verifies the URL), then subscribe the messages field.

Production: set WHATSAPP_APP_SECRET (your Meta app secret) in the server environment so incoming webhooks are signature-checked, and keep a queue worker running.

How a message round-trips

A customer messages your number → Meta posts it to /whatsapp/webhook → MagizAI creates a conversation tagged WhatsApp → the bot replies through the WhatsApp Cloud API → the thread appears in your Inbox, where your team can take over.

Meta rules: WhatsApp sends plain text both ways (no cards). And Meta only lets you message a customer within 24 hours of their last message, or via an approved template — a WhatsApp policy enforced on Meta's side.