Skip to content

Connect Meta Ads to WhatsApp conversions in Timi

Connect the right Meta business, dataset and ad account in Timi Settings, verify a real CTWA outcome, and understand what a setup test proves.

20 July 2026 · 7 min read · Timi Labs

A Nairobi electronics seller can reconcile an M-Pesa payment but cannot find the matching ad outcome. Before blaming the ad, check the connection: is Timi linked to the business and ad account that actually run the shop's Click-to-WhatsApp campaigns?

Open Settings → Ad conversion tracking → Connect Meta Ads, complete the selections shown, and verify a genuine ad-chat outcome. Connection is one prerequisite; sales still need to be recorded, supported attribution must be present, and Meta controls campaign reporting. A successful login alone does not prove the whole chain works.

This is the Settings walkthrough. Read how CTWA attribution works for the source path, or Ads Manager reporting for campaign columns. Customer-list sync is a separate workflow with five intended audiences, still awaiting approval and production verification.

Before you start

Confirm you have:

  • A Timi account with WhatsApp Business already connected in Settings
  • A Meta ad account with at least one pixel (dataset) attached
  • Facebook login access to the Business Manager that owns that pixel
  • Click-to-WhatsApp ads using WhatsApp as the destination — not a website URL or organic chat link

If you have not connected WhatsApp in Timi yet, finish WhatsApp Business setup first. Conversion tracking depends on live chats on your connected number.

What OAuth connection actually does

When you click Connect Meta Ads, Timi requests permission to send Conversions API (CAPI) events to the pixel you select. Timi stores the connection securely — you do not paste long-lived tokens unless you use Advanced settings for edge cases.

After a successful connect, Timi sends Conversions API events for Click-to-WhatsApp ad chats when milestones happen in chat (organic bio and Status traffic is handled in Feed — not reported to Meta for ad optimisation):

  • Engaged ad chat (beyond a bare "Hi"): Lead submitted (LeadSubmitted)
  • Qualified buyer (clear product or price interest): Qualified lead (QualifiedLead)
  • Seller handoff (ready to pay): Checkout started (InitiateCheckout)
  • M-Pesa confirmed or mark sold: Purchase (Purchase)

These events report recorded outcomes. They do not automatically switch your campaign objective or guarantee better delivery; available optimisation depends on Meta eligibility and campaign configuration. Ads Manager may show custom names if your media buyer renamed events in Settings. For when Purchase fires in practice see when Timi sends Purchase. For bare Hi openers see qualified vs thin Hi.

Connect Meta Ads in Timi — step by step

  1. Open Settings → Ad conversion tracking.
  2. Click Connect Meta Ads.
  3. Sign in with the Facebook account that manages your ads and Business Manager.
  4. Complete the business, pixel/dataset and ad-account selections Timi shows. Choose the assets used for this shop’s WhatsApp campaigns. If more than one ad account is available, select the correct account for spend reporting.
  5. Review permissions and confirm.
  6. Turn on Send conversion events to Meta.

Timi enables conversion tracking automatically after a successful connect. Your pixel ID and access token are stored server-side. Most sellers never need the Advanced manual token fields.

Verify connectivity, then a real ad outcome

A test event checks part of the connection. Timi's current test sends a setup event; it does not simulate a real CTWA Purchase or prove campaign attribution.

  1. Open Events Manager for the selected dataset. If using Test events, copy its test code into the Timi test-event field.
  2. Click Send test event in Settings and read the result and destination hint.
  3. With a matching test code, check Test events → Website. Without a code, check Overview rather than expecting the event in Test events.
  4. Separately inspect a genuine buyer conversation from a CTWA ad. Check its ad-source label and the relevant entry in Timi's event log.
  5. For a real sale, reconcile payment and confirm M-Pesa or mark sold in Feed. Check the recorded event status and then Meta's reporting view.

The test and real business-messaging outcomes can have different reporting destinations. Follow the event's destination and the Settings hints, rather than assuming every event appears on the website pixel selected for the setup test. Do not fabricate a purchase to validate the connection.

If the test fails, read its error before reconnecting. A missing asset may be a permissions issue; an accepted test with no real conversions may instead mean no eligible ad chat or recorded sale yet. Use Purchase troubleshooting to separate those cases.

Map events (optional)

Default mapping works for most Kenyan SMEs:

  • Engaged ad chat → Lead submitted
  • Qualified buyer → Qualified lead
  • Seller handoff → Checkout started
  • Paid sale → Purchase

You can rename events in Settings if your media buyer uses custom conversion names in Ads Manager. Keep names consistent across Timi and the columns your buyer filters on every Friday.

Disconnect and reconnect safely

If events land on the wrong pixel:

  1. In Timi Settings, disconnect Meta Ads.
  2. Reconnect and carefully select the correct Business Manager and dataset.
  3. Send another test event before resuming spend.

Check the selected assets and a genuine outcome before relying on the report for budget decisions. A setup test is useful evidence of connectivity, not a promise of campaign results.

Troubleshooting

Events not showing in Events Manager

  • Confirm Connect Meta Ads succeeded (green status in Timi)
  • Tracking toggle is on
  • Buyer came from a Click-to-WhatsApp ad — paid chats show attribution labels in Timi Feed
  • You are looking at the event destination and the appropriate test or live reporting view

Purchase events missing but Lead submitted events arrive

  • Buyer may not have paid yet — Purchase fires on M-Pesa confirmation or mark sold
  • Check that your team marks sold consistently for cash and till payments — see when Timi sends Purchase

Wrong pixel receiving events

  • Disconnect and reconnect, selecting the correct Business Manager and dataset

Organic chats

  • Timi does not report organic WhatsApp chats to Meta for ad optimisation — only Click-to-WhatsApp ad chats carry the referral data CAPI needs
  • Keep organic bio and Status traffic separate in Feed and CRM. Use CTWA for the supported paid-chat attribution path; reporting alone does not select a campaign performance goal

Incomplete connection and fit

If Meta connection is unavailable and you defer it, attribution remains incomplete. Do not interpret missing spend or Purchase reporting as a measured zero. Return to Settings when the account owner has resolved access, then repeat the real-outcome check.

New Timi shops must sell products mainly through WhatsApp and currently run Meta ads opening WhatsApp. There is no website or minimum-volume requirement. AI replies remain optional. See the ads overview and pricing, then use Connect WhatsApp below to check fit and start setup.

Common mistakes during setup

  • Connecting Meta Ads before WhatsApp Business is linked in Timi
  • Selecting a website pixel unused by WhatsApp campaigns
  • Turning on tracking but running ads to a wa.me link instead of Click-to-WhatsApp
  • Skipping the test event and discovering broken CAPI after KES 20,000 in spend
  • Expecting spreadsheet uploads and OAuth tracking to both be the source of truth — pick live CAPI

For the full ads funnel — campaign structure, creative, and weekly review — see the WhatsApp ads pillar guide.

FAQ

Do I paste a pixel ID manually? Usually no. OAuth handles pixel selection. Advanced settings exist for agencies with non-standard setups.

Does this work for Instagram-only ads? Yes, if the ad destination is Click-to-WhatsApp to your business number.

Will organic Instagram bio traffic send Purchase events? Timi reports eligible CTWA outcomes, not organic bio sales. Missing referral information is an attribution gap, not evidence that a chat was organic.

How long does setup take? Connecting can be quick when permissions and assets are ready, but account access and verification can add steps. Check the status shown rather than assuming a guaranteed time.

Can my media buyer help connect? Use an authorized teammate with appropriate Timi and Meta asset access. Each person should use their own login; do not share passwords.

Connect Meta Ads to WhatsApp conversions in Timi | Timi