Raw WhatsApp Cloud API Setup
ReplyBase allows you to connect directly to Meta's Cloud API. This "Raw" integration gives you full control over your WhatsApp Business Account and avoids third-party provider fees.
How WhatsApp Cloud API Works
Unlike standard WhatsApp, the Cloud API sends message data directly from Meta's servers to ReplyBase via Webhooks. This allows our AI to respond instantly without needing a physical phone connected.
Developer Account Required
1Create a Meta Developer App
Go to the Meta for Developers portal and log in.
- Click My Apps and then Create App.
- Select Other as the app type and click Next.
- Select Business as the app type.
- Enter an App Display Name (e.g., "ReplyBase Integration").
- Choose your Business Account from the dropdown.
- Click Create App.
2Add WhatsApp Product
Once your app is created, you will be taken to the dashboard.
- Scroll down to find WhatsApp and click Set Up.
- Meta will ask you to select or create a Meta Business Account. Ensure you select the correct one.
- Once finished, you'll be redirected to the Getting Started page under the WhatsApp menu.
3Configure Webhooks
This is the most critical step. Webhooks allow ReplyBase to receive messages in real-time.
Copy these values from ReplyBase
https://app.replybase.co.uk/api/whatsapp/webhook[Found in your ReplyBase Channel Settings]- In the left menu, go to WhatsApp > Configuration.
- Click Edit next to Webhooks.
- Paste the Callback URL and Verify Token from above.
- Click Verify and Save.
- Now click Manage next to Webhook Fields.
- Find messages in the list and click Subscribe. This is mandatory.
4Generate Permanent Access Token
Critical Note
To generate a permanent token:
- Go to your Business Settings (business.facebook.com/settings).
- Navigate to Users > System Users.
- Create a new System User (e.g., "ReplyBase_User") with the Admin role.
- Click Add Assets and assign your Meta App to this user with full control.
- Click Generate New Token.
- Select your App and then check these two permissions:
whatsapp_business_messagingwhatsapp_business_management
- Click Generate. **Copy this token immediately** as Meta will never show it again.
5Finalize in ReplyBase
Now, go back to your ReplyBase Dashboard and complete the connection:
- Go to Channels > WhatsApp.
- Select Meta Cloud API (Raw).
- Enter your Phone Number ID (found in Meta Dashboard > WhatsApp > Getting Started).
- Enter your WhatsApp Business Account ID (found in the same place).
- Paste the Permanent Access Token you just generated.
- Click Verify Connection.
Setup Verification
To ensure everything is working correctly, send a test message to your registered WhatsApp number. You should see:
1. Meta Received
Check the "Webhook Logs" in Meta Dashboard to see if the event was sent.
2. ReplyBase Captured
The message should appear in your "Conversations" tab within 2-3 seconds.
Stuck on a step?
Our integration experts can guide you through the Meta setup.