Meta Ads uses Meta’s Marketing Graph API v23. You need the WhatsApp Cloud API engine and a Meta Business account with an ad account, Page, and WhatsApp Business Account (WABA) that all belong to the same Business Manager.
What you need before you start
Gather these five values — all of them come from Meta Business Manager. Keep them handy for the setup wizard.Connecting your ad account
1
Open the integration
Go to Settings → Integrations → Meta Ads and click Connect.
2
Paste your credentials
Enter the Ad Account ID, Page ID, WABA ID, Phone Number ID, and the system user token.
3
Validate
Soneka calls
/me and /{ad_account_id} on the Graph API to confirm the token has the right scopes and that all four objects live in the same Business Manager. Errors are shown inline (see Troubleshooting).4
Save
Once validated, Meta Ads appears in the sidebar for anyone with the Marketer role or above.
Building a campaign
Open Meta Ads → New campaign. The wizard is five steps.Step 1 — Objective
Pick what you want to optimize for. Soneka maps each choice onto Meta’s outcome model.Step 2 — Audience
Define location, age, gender, languages, and detailed targeting (interests / behaviours). You can also pick a saved audience or a custom audience from your ad account.Step 3 — Placement & budget
- Placement — Automatic (recommended) or manual (Feed, Reels, Stories, Marketplace, etc.).
- Budget — daily or lifetime, with a start and end date.
- Bid strategy — lowest cost is the default; switch to a cost cap if you need it.
Step 4 — Creative
Upload the image or video, write the primary text, headline, and description. The preview updates live. The CTA is fixed to Send WhatsApp Message and the destination is your connected phone number.Step 5 — Entry flow
Optionally attach a flow that runs the moment a click arrives:- Pre-fill a message so the contact just taps Send.
- Tag the contact with the ad and ad set they came from (for attribution in Analytics).
- Send a welcome message and route to the right team.
Monitoring performance
Each campaign has its own dashboard with:- Impressions, Reach, Clicks, CTR, CPM, CPC — pulled from Meta insights.
- Conversations started — unique contacts who sent a first message from the ad.
- Cost per conversation — spend divided by conversations started.
- Downstream conversions — goals reached in the linked flow (bookings, deals created, payments received).
Pausing, editing, and deleting
From the campaign detail page:- Pause / Resume flips the Meta status without deleting anything.
- Edit budget / schedule updates the ad set. Creative changes redeploy the ad and reset learning.
- Delete removes the campaign in Meta and in Soneka. Insights history stays visible for 90 days.
Troubleshooting
Soneka surfaces Meta’s raw error codes so you can act on them.Related
- Flow Builder — the entry flow that runs on every CTWA click.
- Analytics — attribution and cost-per-conversation reporting.
- Team Inbox — auto-assign incoming ad clicks to the right team.