Skip to main content
Who can use this?
  • Gallabox users with CTWA access on their plan.
  • Roles: Owners and Admins (and roles with the relevant permission).

Plan Availability

CTWA Ads analytics is available on Essential and Advanced. See Ad Campaigns for the complete plan matrix.

Why CTWA Ads?

Connecting your Facebook Ad Account to Gallabox unlocks three things:
  1. Lead enrichment — Every CTWA conversation in Gallabox automatically shows which ad it came from (Ad ID, Ad name, Ad Set, Campaign, source URL). Your team can see exactly what ad a customer clicked before they messaged — this context enriches conversations and helps agents qualify leads faster.
  2. Ad management — See ad performance (spend, reach, link clicks, cost per result, eligible leads, purchases) from inside Gallabox alongside your conversations. No switching between Meta Ads Manager and your WhatsApp inbox. Analytics covers leads from both Facebook and Instagram CTWA ads in one place.
  3. Syncing with Meta — Connecting your Facebook Ad Account brings live ad data into Gallabox. Combined with CAPI (Conversions API), you can send conversion outcomes back to Meta so it can optimize your ads toward real results — not just clicks.

What is CTWA Ads?

CTWA Ads is Gallabox’s ad analytics view for Click-to-WhatsApp campaigns. It connects to your Facebook Ad Account and pulls ad performance data from Meta — so you can see which specific ads are driving WhatsApp conversations, what they cost, and what return you’re getting, without leaving Gallabox.
When a contact messages you from a Click-to-WhatsApp ad, Gallabox captures the Ad ID and source URL and attaches it to the conversation. The CTWA Ads view aggregates this data across all contacts into ad-level analytics.

The 72-Hour Ad Engagement Window

When a contact starts a conversation from a CTWA ad click, Meta provides a 72-hour free entry-point conversation window — Meta does not charge a per-message fee for that conversation during this period. Gallabox displays a countdown timer in the conversation; the timer begins once your team responds to the customer. This is a conversation-fee benefit, separate from the standard 24-hour customer service window that governs free-form messaging.

Prerequisites

  1. A Facebook Ad Account running Click-to-WhatsApp campaigns.
  2. A WhatsApp channel connected in Gallabox.
  3. Owner or Admin access in Gallabox (or a role with the relevant permission).
  4. Facebook page admin or ad account access — you’ll authorize via Facebook OAuth.

How to Connect Your Facebook Ad Account

1

Connect to Facebook

  1. Go to CTX → CTX Ads in the left navigation.
  2. Click Connect Facebook Ad Account.
  3. Click Connect with Facebook — you’ll be redirected to Facebook’s authorization screen.
  4. Log in with a Facebook account that has access to your Ad Account.
  5. Grant all requested permissions — Gallabox needs access to read your ad data.
  6. Select the Ad Account(s) you want to connect.
  7. Click Confirm.
Grant all requested permissions. Skipping any will cause incomplete data or connection failure.
2

Verify the connection

After authorizing, Gallabox shows a connection status badge:
  • CTWA connection — whether your Ad Account is linked and syncing ad data
  • CAPI connection — whether Gallabox can send conversion events back to Meta (configured separately — see CAPI)
If either shows an error, click the badge to see the missing permission.
3

Sync your ads

Gallabox performs a full sync on first connection to pull all your ad data. After that, ad performance data syncs from Meta automatically once a day.To manually trigger a sync: click Sync Ads in the CTWA Ads view. Manual sync can be triggered once every 30 minutes.

Reading the CTWA Analytics

Campaign Summary

The CTWA dashboard summarizes your campaign performance over a selected period:
  • Ad Spend: The total amount spent on your CTWA ads in the selected time frame.
  • Reach: The number of unique people who saw your ad.
  • Link Clicks: The number of times users clicked the ad link that redirects them to WhatsApp.
  • Conversations Started: How many users started a conversation after clicking the ad.
  • Cost per Result: The average cost for each conversation initiated.
  • Eligible Leads: The number of potential leads generated.
  • Purchases: If tracking is set up, this shows how many purchases happened due to the campaign.
Use the filter to select a custom time frame and view results specific to that duration.

Ad-Level Insights

Each ad is tracked individually, and the dashboard displays:
  • CTWA ID and Name: Unique identifier and name of the ad.
  • Status: Whether the ad is active, paused, or completed.
  • Ad Set ID and Name: The group of ads it belongs to, used for targeting and budget settings.
  • Campaign Set ID and Name: The overall marketing objective or campaign these ads are part of.
  • Created Date: When the ad was first published.
  • Ad Spend: Budget used specifically for this ad.
  • Reach / Link Clicks / Conversations Started: Individual metrics to see how this specific ad is performing.
  • Cost per Result: How much you’re paying per conversion (e.g., per conversation).
  • Eligible Leads and Purchases: Results directly attributed to this ad.
ROAS (Return on Ad Spend — revenue ÷ spend) is not a column in the ads table. It appears as a stat card when you drill into an ad’s leads view, and requires CAPI purchase tracking to have data.

Filtering by Date Range

Use the date range picker to filter metrics. Default range is the past 7 days; change it to any custom period.

Drilling into an Ad

Click any ad row to open CTWA Leads filtered to that ad — showing the individual conversations and contacts that came from that specific ad. See CTWA Leads.

Export CTWA Reports

To export CTWA reports in Gallabox, follow these steps:
  1. Click on the “Export” option and select the CTWA Summary option from the dropdown.
  2. Select the date range for the report you wish to export.
  3. Click on the “Initiate Exports” button to start the process. Click on “Download Export File” to download the generated file.
After clicking the export button, the system will generate the report, which is downloadable as a CSV or Excel file.
Export time may vary based on the data range and size of the report. Exporting requires the PII-read and bulk-read permissions on your role. Without them, the Export option is hidden.

Multiple Ad Accounts

Use the Ad Account selector at the top to switch between connected ad accounts. To add another: click Add Ad Account.

Example

Scenario: You run a clothing brand with two Facebook campaigns — a new arrivals campaign and a sale campaign. Both use Click-to-WhatsApp ads. You want to know which campaign is actually converting to purchases, not just starting conversations. Here’s how you’d use it:
  1. Open CTWA Ads.
  2. Set the date range to the campaign period.
  3. Compare the two campaigns:
    • New arrivals: 500 conversations, 120 eligible leads, 15 purchases
    • Sale campaign: 2,000 conversations, 80 eligible leads, 8 purchases
  4. The sale campaign drives more conversations but fewer quality conversions — you can reallocate budget to the new arrivals campaign.
  5. Click the new arrivals ad row to open CTWA Leads and see which specific contacts purchased, so your sales team can follow up.

FAQs

  1. Check the connection status badge — if it shows an error, reconnect via Reconfigure.
  2. Click Sync Ads to trigger a manual sync.
  3. Verify the date range includes the period when the ads were running.
  4. Only Click-to-WhatsApp ads appear here — standard Facebook/Instagram ads won’t show.
ROAS requires purchase conversion events to be set up and firing successfully via CAPI. If CAPI is not configured or no purchase events have been sent, ROAS will not have data. See CAPI setup.
Small differences are normal: attribution window differences, sync delays, and the fact that eligible leads and purchases are Gallabox-defined CAPI events (not Meta’s native metrics).

Next Steps