Support for Capturing Metadata from WA Cloud Channel (e.g., CTWA-CLID)

[admdanielspalma]

Hello,

I use Typebot integrated with the official WhatsApp API, which exchanges messages through Webhooks. The metadata included in these Webhooks is critical for advanced functionalities. For example, when a message is sent via a Click-to-WhatsApp Ad, the Webhook includes a ctwa_clid parameter that is essential for attribution and sending accurate conversion data back to Meta.

Here’s an example of a Webhook payload for a message sent via an ad:

[ { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "1234567890", "phone_number_id": "9876543210" }, "contacts": [ { "profile": { "name": "John Doe" }, "wa_id": "112233445566" } ], "messages": [ { "referral": { "source_url": "https://fb.me/exampleAd", "source_id": "1234567890", "source_type": "ad", "body": "Sample Body", "headline": "Chat with us", "media_type": "image", "image_url": "https://example.com/image.jpg", "ctwa_clid": "EXAMPLECTWACLID123456" }, "from": "112233445566", "id": "wamid.EXAMPLEID123456", "timestamp": "1732755104", "text": { "body": "Hi! I'm interested and would like more details." }, "type": "text" } ], "field": "messages" } ]
I kindly request that Typebot supports capturing and utilizing these metadata details, such as ctwa_clid, from Webhooks. This would allow for seamless attribution and enhanced conversion tracking within the platform.

If this functionality already exists, I would appreciate instructions on how to configure it.

Thank you for your consideration!

Best regards,
Daniel

[baptisteArno]

That's very good to know! Thank you. Do you know other important things to track other than ctwa_clid?

[admdanielspalma]

That's very good to know! Thank you. Do you know other important things to track other than ctwa_clid?

Great! I’m glad you liked it; this will be a very useful feature.

The most important and critical aspect is simply knowing which ad the contact came from. When we receive a message directly in the Meta app, it is labeled as "sent via ad" and includes the thumbnail and the source link, which helps us identify which ad the customer interacted with. Currently, Typebot doesn’t capture this data, but it could since these details are already present in the webhook.

The ctwa_clid, which is the click ID for the ad, allows for better attribution of events, as just relying on the phone number is often insufficient.

Also critical is the AD ID, messages.referral.source_id , with it I can check the ad details through the API.

Additionally, it would be extremely valuable for Typebot to allow access to the full history of received webhooks. This could be an optional feature.

Or just allow users to capture data in the same way they do when interacting with APIs using the HTTP module. This way, users could adapt as needed and handle changes to the Meta API without relying on urgent updates to the platform.

You might also be interested in the data available in the Evolution API (for regular WhatsApp). You can check this out here (you'll have to use a translator os just check the json example data):

EvolutionAPI/evolution-api#975

Thanks!