Connect your WhatsApp Business account to Mojeeb and let your AI agent handle customer conversations on WhatsApp automatically. Mojeeb supports text, images, audio, video, documents, message templates, and broadcasts — all powered by your Knowledge Base and managed through a single dashboard.
How do I connect WhatsApp?
Mojeeb uses the WhatsApp Business Cloud API to connect your WhatsApp number:
- Go to Connect in the sidebar
- Find WhatsApp Business in the "Add Connections" section
- Click Connect +
- Authorize your WhatsApp Business account via Meta's OAuth flow
- Select the phone number you want to connect
- Your agent starts receiving and responding to WhatsApp messages immediately
You can connect multiple WhatsApp numbers to the same agent. Each connection shows its phone number, status, and whether messages are enabled.
Requirements:
- A WhatsApp Business account with access to the Cloud API
- An active, verified WhatsApp Business phone number
- OAuth permissions granted to Mojeeb
What features are supported?
| Feature | Description |
|---|---|
| Text messages | Send and receive text conversations with AI-powered auto-replies |
| Media messages | Images (JPG, PNG), audio, video (MP4), and documents (PDF, DOCX, etc.) |
| Message templates | Pre-approved templates for outbound messaging outside the 24-hour window |
| Broadcasts | Send template messages to multiple recipients via CSV upload |
| Auto-replies | AI processes incoming messages and responds using your knowledge base |
| Lead capture | Automatically collect customer name, phone, and conversation summary as leads |
| Follow-ups | Automated follow-up messages to re-engage inactive customers |
| Human takeover | Switch any conversation to human mode from the Chats page |
What is the 24-hour messaging window?
WhatsApp Business API has a 24-hour customer service window. When a customer sends you a message, you have 24 hours to reply with regular text and media messages for free. After 24 hours, you must use a pre-approved message template to re-initiate the conversation.
In the Chats page:
- Active window — A green banner shows the remaining time (e.g., "12h 34m remaining"). You can send regular messages freely.
- Expired window — An amber banner replaces the message composer. You must click "Send Template" to send an approved template message.
What are WhatsApp message templates?
Templates are pre-approved message formats that you can send at any time — even outside the 24-hour window. Every template must be approved by Meta before use.
How do I create a template?
- Go to the WhatsApp management section in your dashboard
- Click Create Template
- Configure the template:
| Component | Required | Description |
|---|---|---|
| Name | Yes | Lowercase, snake_case identifier (e.g., welcome_message) |
| Category | Yes | Marketing, Utility, or Authentication |
| Language | Yes | e.g., en_US, ar_SA |
| Header | No | Text (with 1 variable), image (JPG/PNG, 16 MB max), video (MP4, 16 MB max), or document (PDF, 16 MB max) |
| Body | Yes | Message text with variables: {{1}}, {{2}}, etc. |
| Footer | No | Plain text (no variables) |
| Buttons | No | Up to 10 buttons: URL (max 2), phone number (max 1), or quick reply (max 10) |
- Submit for Meta approval
- Monitor the template status: Approved, Pending, Rejected, Paused, or Disabled
How do I send a template?
You can send a template message in two ways:
- From a conversation — Open any WhatsApp conversation in Chats and click the Templates button in the composer. Select an approved template, fill in the variables, and send.
- To a new contact — Use the send template feature to enter a phone number, select a template, fill parameters, and send proactively.
How do broadcasts work?
Broadcasts let you send a template message to multiple WhatsApp recipients at once. This is useful for announcements, promotions, and updates.
- Create a broadcast campaign
- Upload a CSV file with recipient phone numbers (with country code) and optional names
- Select an approved message template
- Fill in template variables
- Send the broadcast
Each recipient's delivery status is tracked individually: pending, sent, delivered, read, or failed. The broadcast shows overall progress and you can monitor failures.
How do I manage connection settings?
Each WhatsApp connection on the Connect page shows:
- Phone number — The connected WhatsApp Business number
- Messages On/Off — Toggle to enable or disable auto-replies
- Three-dot menu — Disconnect or modify settings
The "Messages On" toggle controls whether the AI agent automatically responds to incoming WhatsApp messages. When off, messages are still received but no auto-reply is sent.
Common questions
Do I need a WhatsApp Business account?
Yes. You need a WhatsApp Business account with access to the Cloud API. Mojeeb uses Meta's official WhatsApp Business API — personal WhatsApp accounts cannot be connected.
Can I connect multiple WhatsApp numbers?
Yes. You can connect multiple WhatsApp Business numbers to the same agent. Each number appears as a separate connection in the Connect page.
Can I use my existing WhatsApp number?
Yes. You can connect your existing WhatsApp Business number to Mojeeb. The number must be registered with WhatsApp Business and verified with Meta.
Is there a message limit?
WhatsApp has its own messaging limits based on your account tier and quality rating. Mojeeb operates within these limits. Template messages and business-initiated conversations may incur costs from Meta.
What happens if a template is rejected?
If Meta rejects your template, you will see the "Rejected" status in your template list. You will need to create a new template with modified content that meets Meta's guidelines. Rejected templates cannot be resubmitted.
Can I send media in broadcast messages?
Yes, if your template includes a media header (image, video, or document). The media is uploaded during template creation and included in every broadcast message.