Integrations
Google Click-to-WhatsApp (CTWA)

Google Click-to-WhatsApp (CTWA)

Copy as markdown

|

View as Markdown

WhatsApp

Google Click-to-WhatsApp (CTWA) connects your Google Ads to WhatsApp chats, helping you convert ad clicks into real conversations.

This guide will help you track these sessions, measure impact, and improve ad performance across platforms.



Overview

CTWA lets users message your business on WhatsApp by clicking on a Google ad. While this moves user into a private chat, it also interrupts standard online tracking. To counter this, the system uses two values:

  • Click ID (GCLID) from Google Ads: Identifies which ad the user clicked.
  • Chat ID: Added to the messages to link the chat session to the ad.

Together, these two values provide visibility into what happens after the ad is clicked, for example, if the user asked about the product, booked a service, or submitted their details. This makes it possible to report conversions from WhatsApp back into Google Ads and improve campaign performance.

This guide explains how to:

  • Connect your Message Ads with Infobip
  • Redirect users to WhatsApp with personalized messages
  • Enable conversion tracking using Ads Data Manager


Features

Seamless ad-to-chat experience

Automatically redirect users from Google Ads into a WhatsApp chat with zero friction.

Campaign tracking automation

Captures both GCLID and a unique Chat ID to attribute conversations to paid clicks.

Custom starter message

Prefill messages in WhatsApp to create a personalized and consistent user entry point.

Offline conversion syncing

Supports daily data uploads to Google Ads through Amazon S3 for performance attribution.



What you will need

To complete this setup, prepare the following:

  • Infobip account: If you do not have an account, you can create one.
  • Google Ads account: You must have a Google Ads account with Message Ads enabled.
  • Your account manager will share the rest of the necessary info with you:
    • Active WhatsApp sender (without the + prefix)
    • Conversion import URL: The webhook URL provided by Infobip to capture GCLID and Chat ID for each click.
    • Amazon S3 bucket: Provided and shared by Infobip to upload offline conversions to Google Ads using Ads Data Manager.


Set up Google Click-to-WhatsApp

Configure Google Click-to-WhatsApp Integration app

  1. Install the Google Click-to-Chat Integration app from the App Marketplace (opens in a new tab). If you need access, contact your account manager.

    GCTWA - App Marketplace
  2. After installation, select Create configuration.

    GCTWA - Create configuration
  3. Choose the phone number you will be using, enter a name for the configuration, and select Create configuration.

    GCTWA - Select phone number and configuration name
  4. Fetch the conversion import URL (messaging webhook) by selecting the configuration name.

    GCTWA - Fetch conversion import URL GCTWA - Messaging webhook

Add the Amazon S3 bucket

To collect converted leads, continue with these steps:

  1. Contact your account manager to create the Amazon S3 bucket that will be used to collect converted leads.

  2. Once the bucket is created, your account manager will notify you. Return to the Google Click-to-Chat Integration app and select your configuration.

  3. You will now see additional details about the S3 bucket.

    GCTWA - Select phone number and configuration name

Configure Google Message Ads

Create a Message Asset

  1. Go to your Google Ads account (opens in a new tab) and open the Message Asset configuration.

  2. Set the Conversion Import URL to the webhook provided by Infobip.

    GCTWA - Google Message Ads - Conversion Import URL
  3. Add your Infobip-provisioned WhatsApp number (without the + sign).

  4. Define your starter message, for example:

    Hi, I am interested in learning more.

    NOTE

    The starter message is what the user sends to you, not your welcome message. Write it to reflect user intent.

  5. Save the asset and apply it to your ad campaign.


Import conversions using Ads Data Manager

  1. In Google Ads (opens in a new tab), go to Goals > Conversions > Summary and select New conversion action.

  2. Choose Amazon S3 as your data source with a direct connection.

  3. Enter the credentials and bucket link provided by Infobip.

  4. Upload a sample CSV file with at least one row of data to validate the schema. This is an important step as the setup will not complete without this.

  5. Define your synchronization schedule (recommended to set to once per day).


Send conversions using Google Ads API

After Ads Data Manager is set up, you can also send real-time offline conversions using the Google Ads API (opens in a new tab). You can trigger these from Infobip's customer engagement solution flows or call Infobip's API (opens in a new tab) directly.

Contact Infobip support (opens in a new tab) to enable the required API scope for your API key. This unlocks the /google-ads/conversion endpoint.

Example request

bash
curl -X POST "https://api.infobip.com/google-ads/conversion" \
 -H "Authorization: App <API KEY>" \
 -H "Content-Type: application/json" \
 -d '{
       "sourceId": "+48123456789",      // phone number connected to messaging ad
       "ctwaReference": "+48123456782", // phone number of the user in the chat
       "details": {
         "value": 100.01,
         "currency": "USD",
         "orderId": "21312322"
       },
       "type": "PURCHASE"
     }'






Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary
Service status

Copyright @ 2006-2026 Infobip ltd.

Service Terms & ConditionsPrivacy policyTerms of use