# Google Click-to-WhatsApp (CTWA)
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](https://www.infobip.com/docs/essentials/getting-started/create-an-account).
- **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](https://portal.infobip.com/exchange). If you need access, contact your account manager.

2. After installation, select **Create configuration**.

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

4. Fetch the conversion import URL (messaging webhook) by selecting the configuration name.

### 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.

### Configure Google Message Ads

#### Create a Message Asset

1. Go to your [Google Ads account](https://ads.google.com/) and open the **Message Asset** configuration.

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

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](https://ads.google.com/), 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](https://developers.google.com/google-ads/api/docs/conversions/getting-started). You can trigger these from [Infobip's customer engagement solution](https://www.infobip.com/docs/product-documentation#customer-engagement) flows or call Infobip's API directly.

Contact [Infobip support](https://www.infobip.com/contact) 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"
      }'
```
___