> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/en/marketing-and-attribution/meta-ads/meta-conversions-api/ctwa-offline-conversions.md). # How to add business messaging events to your website dataset This is the path for teams that **already have a website dataset** and want to use it for CTWA too, instead of a separate business messaging dataset. (If you don't have a messaging-capable dataset, Patagon AI creates one for you automatically — see [The dataset your CTWA conversions need](/en/marketing-and-attribution/meta-ads/meta-conversions-api.md#the-dataset-your-ctwa-conversions-need).) If you are running **Click-to-WhatsApp (CTWA)** ads and your dataset was originally created for **web** events (or it's a generic dataset), Meta will reject CTWA conversions even after you connect the dataset in Patagon and Events Manager. The error you'll see is *"the dataset must have a WhatsApp Business account associated"*. The fix is not to swap the dataset: your existing website dataset is fine. You need to **add a Messaging data source** that connects your Facebook Page (and through it, your WABA) to that same dataset. After that, the dataset has both web and messaging signals flowing into it, and CTWA conversions are accepted. You only do this once per dataset. {% hint style="info" %} This is the CTWA-specific add-on to the main setup. If you haven't done it yet, complete [How to connect Meta and map conversions](/en/marketing-and-attribution/meta-ads/meta-conversions-api.md) first — this page picks up from there. {% endhint %} ## Prerequisites * You've already connected Meta in Patagon (the "Patagon-side" setup in [How to connect Meta and map conversions](/en/marketing-and-attribution/meta-ads/meta-conversions-api.md)). * The Facebook Page you're going to connect is the **same Page your WABA is bound to** in Meta Business Settings → WhatsApp Accounts. If you connect a different Page, Meta will create the link successfully but CTWA conversions will still fail. * Admin access to Meta Business Manager. ## Step 1. Open your dataset in Events Manager Go to [Meta Events Manager](https://business.facebook.com/events_manager) and open the dataset you selected in Patagon (the one receiving your CTWA conversions). ![Open the dataset in Events Manager](/files/jvbNoTGta3NqEQZ5jcWC) ## Step 2. Connect a new data source — choose Messaging In the dataset, click **Add events** (or the green **Create** button) → **Connect a new data source**. Pick **Messaging** as the source type. This is the step most customers miss. Web and CRM data sources will not satisfy Meta's WABA requirement for CTWA — only Messaging will. ![Connect a new data source — Messaging](/files/8lyhz4w4xDmqgeznCwcs) ## Step 3. Connect a Facebook Page To share data from business chats you need to connect either a Facebook Page or an Instagram profile. **Choose Facebook Page** — the WhatsApp Business Account is linked to Meta through the Page, not directly. ![Choose Facebook Page or Instagram](/files/kYMlogxBGcAShEoh0fSE) ## Step 4. Select the Page tied to your WABA Pick the Facebook Page that your Patagon WABA is linked to. If you're not sure which one, go to **Meta Business Settings → WhatsApp Accounts**, open your WABA, and check which Page is associated with the phone number Patagon is using. {% hint style="warning" %} The Page you pick **must** be the one your WABA is attached to. If you connect a different Page, Meta will create the link successfully but CTWA conversions will still fail. {% endhint %} ![Select the Facebook Page tied to your WABA](/files/iPNsknJrNHWmcaMTUOx8) ## Step 5. Set up with existing data — pick your current dataset Meta will offer to **create a new dataset** or **set up with existing data**. Choose **Set up with existing data** and select the **same dataset** you connected in Patagon. This is what merges your messaging events into the dataset that already receives your web events. If you create a new dataset here instead, you'll have two disconnected datasets and your Patagon connection will keep firing into the wrong one. ![Set up with existing data — choose your dataset](/files/K4QK81w0RnDDKAZFY8XD) ## Step 6. Connect your Instagram account (optional) Meta will offer to also connect an Instagram account. This is optional and only matters if you also run Click-to-Instagram ads. Skip if you don't. ![Optional — connect Instagram](/files/e0AWq3IGzDoir5yHZn1O) ## Step 7. Confirm the link You should see a confirmation that your event data is now linked to your Page and dataset. ![Link complete](/files/TVXIYxWd82R79FFAvoLD) ## Step 8. Choose path — Direct integration When asked to choose how to send events, pick **Direct integration**. Patagon sends events directly to Meta's Conversions API; you do not need a partner integration. ![Choose Direct integration](/files/L1Ue1ne1zb6ge9kiaTG9) ## Step 9. Select the events Patagon will send Select **Purchase** and **LeadSubmitted**. Patagon sends `LeadSubmitted` for every CTWA qualified lead, and `Purchase` if you've configured a purchase event mapping. Keep all required parameters checked — they are auto-filled by Patagon. ![Select Purchase and LeadSubmitted](/files/LAIMVIzpq5syPpkklhmp) ## Step 10. Review and confirm Review the parameter list for each event and click **Confirm Setup**. The required parameters Meta needs (action\_source, event\_name, event\_time, messaging\_channel, page\_id, plus the Click to WhatsApp ID and Page Scoped User ID) are exactly what Patagon sends. ![Review setup](/files/x2io5tGoRVZeRKImapyZ) ## Step 11. Verify the dataset is linked Back on the dataset's **Settings** tab, you should now see your Facebook Page (and Instagram, if you connected it) under **Linked data**. Through that Page, your WABA is now associated with the dataset. ![Linked data on the dataset](/files/eEnH3vA74da9ptR6LClA) Send a test CTWA conversion from Patagon (or wait for the next qualified lead). Within \~1 minute it should appear in Events Manager → **Test events** or **Overview**, with no WABA-association error. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.patagon.ai/en/marketing-and-attribution/meta-ads/meta-conversions-api/ctwa-offline-conversions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.