Raw setup

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.

User Phone
Meta Servers
ReplyBase EngineWebhook Processing
AI Response
WhatsApp API

Developer Account Required

This process requires a **Meta Developer Account** and a verified **Meta Business Suite** account. The setup takes approximately 15-20 minutes.

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

The "Temporary Access Token" shown on the Getting Started page expires every 24 hours. You must generate a Permanent Token for production use.

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_messaging
    • whatsapp_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.

Get Help