MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
WhatsApp

Receive messages

A one-time setup per number so customer WhatsApp messages reach OmniDimension and your agent can reply.

Connecting a number lets you send. To receive customer messages, and let your agent reply, Meta has to forward them to OmniDimension. It's a one-time setup per number, and it also carries WhatsApp calls.

CustomerWhatsApp (Meta)OmniDimension
  1. 1.Sends a messageOpens the 24-hour window
  2. 2.Forwards itNeeds Receive messages set up
  3. 3.Agent writes the replyOr your team, if they took the chat over
  4. 4.Sends the reply from your number
  5. 5.Delivers itRead ticks come back the same way
Messages travel through Meta both ways. Sending works as soon as a number is connected. Receiving needs the one-time Receive messages setup.

Where to find it

Right after connecting, click Receive messages on the Connected screen. Later, click Not receiving messages · Set up on the number card. Then pick one of two methods.

The Receive messages setup, with Connect automatically and Set it up in Meta yourself

Method 1: Connect automatically (recommended)

Copy your Meta app secret

In the Meta App Dashboard, open App settings → Basic and click Show next to App secret. Copy it.

Paste it and activate

Paste it into Meta app secret and click Activate. You see Receiving messages. Everything else, calls included, is set up for you.

Method 2: Set it up in Meta yourself

Prefer not to share your app secret? Keep OmniDimension open on Set it up in Meta yourself so you can copy the Callback URL and Verify token, and open the Meta App Dashboard in another tab.

Open your app's WhatsApp settings

  1. In the sidebar, click Use cases.
  2. Next to Connect with customers through WhatsApp, click Customize.

Meta App Dashboard: Use cases in the sidebar, then Customize

Older apps show WhatsApp → Configuration in the sidebar instead. Don't use App settings → Advanced: its "Authorize callback URL" is for Facebook Login.

Add the callback and subscribe

Configure Webhooks: Callback URL, Verify token, Verify and save, and Webhook fields

  1. Open Step 2. Production setup and find Configure Webhooks.
  2. Paste the Callback URL from OmniDimension.
  3. Paste the Verify token.
  4. Click Verify and save.
  5. Scroll to Webhook fields and turn on Subscribe for:
    • messages (required)
    • calls, if you'll use WhatsApp calls
    • account_update, so a restriction on your account shows in OmniDimension

Good to know

  • To stop the agent replying, turn off Agent replies. This setup stays.
  • If activation fails, the reason shows under the form. See error codes.

Connect a number

Connect a WhatsApp Business number to OmniDimension with your WhatsApp Business account ID and a permanent Meta access token, then register it and pick the numbers to import.

Agent replies

Choose the agent that answers a WhatsApp number, turn its replies on or off, and change how its replies feel to customers.

On this page

Where to find itMethod 1: Connect automatically (recommended)Copy your Meta app secretPaste it and activateMethod 2: Set it up in Meta yourselfOpen your app's WhatsApp settingsAdd the callback and subscribeGood to know