Push CTWA conversion event to Facebook Conversion API

Overview

Use the Lifecycle Rule action Push CTWA conversion event to send Click-to-WhatsApp (CTWA) conversion events from Chakra to Meta Conversions API (Business Messaging). Chakra attributes the event using ctwa_clid from the chat or process marketing source.

Prerequisites

• A Facebook / Meta connection under Admin → Ad Account Connections (required so Chakra can send CTWA conversion events via Meta Conversions API)
• CTWA / WhatsApp ad traffic so the chat or process marketingSource includes ctwa_clid and wabaId
• A WhatsApp Business Account (WABA) that Chakra can use to resolve the Meta conversion dataset
• Permission to create and edit Lifecycle Rules

Connect Facebook / Meta in Chakra

1. Go to Admin → Ad Account Connections (/admin/ad-account-connections).
2. Click Connect Ad Account.
3. For Ad account provider, choose Facebook / Meta.
4. Continue with Facebook and approve the requested permissions (including WhatsApp Business manage events) so Chakra can send Pixel and CTWA conversion events via Meta Conversions API.
5. Confirm the new Meta connection appears in the Ad Account Connections list before creating the Lifecycle Rule.

When to use this action

Choose Push CTWA conversion event for Click-to-WhatsApp conversions. If ctwa_clid is missing, Chakra skips the push (it does not fail the rule as a hard error). For Pixel-based Meta Conversions API or other Meta ad-account OAuth flows that pick a specific ad account / pixel in the action, use Push Conversion to Ad Account instead.

Create the Lifecycle Rule

1. Open Lifecycle Rules and create a rule for the moment you want to count as a conversion (for example process state change or a chat event).
2. Add any event conditions you need (for example only when the lead state becomes converted).
3. Add the action Push CTWA conversion event.
4. Configure the action definition using the fields below, then save and enable the rule.

Action fields

• Event name (required) — Meta event_name such as Lead, Purchase, or a custom name
• Value (optional) — numeric conversion value; handlebars supported
• Currency (optional) — for example INR or USD
• Custom data (optional) — additional event parameters as key/value pairs

How attribution works

• Chakra reads ctwa_clid and wabaId from the chat or process marketingSource.
• Events are sent with action_source=business_messaging and messaging channel whatsapp.
• The Meta dataset is resolved automatically from the WABA when the action runs.

Verify

1. Confirm a Facebook / Meta connection exists under Ad Account Connections.
2. Start a CTWA conversation so Chakra stores ctwa_clid on the chat or process.
3. Trigger the Lifecycle Rule condition (for example move the lead to the converted state).
4. Confirm the rule ran successfully, then check Meta Events Manager for the conversion event.

Notes

• Without a Facebook / Meta Ad Account Connection, Chakra cannot send CTWA conversion events to Meta Conversions API.
• Missing ctwa_clid → action is skipped.
• Dataset resolution failures from the WABA surface as action errors.
• See also the Lifecycle Rule overview under Platform → Features for how events and actions work together.