3 min
Engium connects to WhatsApp through Meta's official WhatsApp Business platform. In most cases you can use the guided setup: open Settings → Integrations Hub → WhatsApp Business and follow the four steps (connect your Meta account, choose your phone number, verify the connection, pick your message templates). The manual steps below are for advanced cases, such as managing your own Meta app.
If you don't have one, go to Meta Business Suite and create a business account. This is free and takes a few minutes.
Open Meta Business Suite ↗Go to Meta for Developers, click 'Create App', and select 'Business' type. Add the WhatsApp product to your app.
Go to Meta for Developers ↗In the WhatsApp section of your app, add a phone number. Meta will send a verification code via SMS or voice call. Important: this number must NOT be already registered on WhatsApp - remove it from WhatsApp first if needed.
In Meta Business Suite → Settings → Business Settings → Users → System Users: create a System User with 'Admin' role, then click 'Generate New Token'. Select the WhatsApp app and grant whatsapp_business_management and whatsapp_business_messaging permissions. Copy the token - you won't see it again.
In Meta for Developers → your app → WhatsApp → API Setup: you'll find both your Phone Number ID (numeric) and WhatsApp Business Account ID.
WhatsApp Cloud API documentation ↗In Engium, open Settings → Integrations Hub → WhatsApp Business and choose the manual connection option. Enter your Phone Number ID, Business Account ID and Access Token, then verify and connect.
After successful verification, Engium provides a webhook URL. Copy it and paste it into your Meta App → WhatsApp → Configuration → Callback URL. Subscribe to 'messages' events. Engium will now receive all incoming WhatsApp messages.
| Field (* = required) | Where to find it |
|---|---|
| Phone Number ID * | Meta for Developers → App → WhatsApp → API Setup → Phone Number ID |
| Business Account ID * | Meta for Developers → App → WhatsApp → API Setup → Business Account ID |
| Access Token * | Meta Business Suite → Settings → System Users → Generate Token (use permanent System User token, NOT the temporary test token) |
Meta charges for the template messages you send (marketing, utility and authentication), at a rate that depends on the country. Replies you send within 24 hours of a customer's message are free. See Meta's pricing page for current rates.
Use a permanent System User Access Token for production. The temporary test token from API Setup expires in 24 hours and will break your integration.
First messages to customers must use pre-approved Message Templates (approve via WhatsApp Manager). After a customer replies, you have a 24-hour window for free-form messages.