[Business message assets](https://support.google.com/ads-help/answer/14077060) appear
on a search results page and function as Click-to-Message (CTM) assets. When a
user clicks a CTM asset, that initiates a messaging connection with the
advertiser on a supported messaging platform (such as WhatsApp, Facebook
Messenger, Zalo, LINE, or SMS).

This feature is restricted using an allowlist in the API. To gain access,
contact your account manager.

## Create a business message asset

You can [create](https://developers.google.com/google-ads/api/docs/assets/working-with-assets#create-an-asset) a business
message asset as you would any other asset using
[`AssetService`](https://developers.google.com/google-ads/api/reference/rpc/v26/AssetService).

The elements required for creation are:

- A [`business message provider`](https://developers.google.com/google-ads/api/reference/rpc/v26/BusinessMessageProviderEnum.BusinessMessageProvider). Supported providers are WhatsApp (`WHATSAPP`), Facebook Messenger (`FACEBOOK_MESSENGER`), Zalo (`ZALO`), LINE (`LINE`, starting in v26), and SMS (`SMS`, starting in v26).
- Provider-specific account information in `message_provider_data`:
  - For WhatsApp (`whatsapp_info`): [`WhatsappBusinessMessageInfo`](https://developers.google.com/google-ads/api/reference/rpc/v26/WhatsappBusinessMessageInfo) identified by a two-letter `country_code` (such as `'US'`) and `phone_number` (such as `'1234567890'`).
  - For Facebook Messenger (`facebook_messenger_info`): [`FacebookMessengerBusinessMessageInfo`](https://developers.google.com/google-ads/api/reference/rpc/v26/FacebookMessengerBusinessMessageInfo) identified by `page_name`.
  - For Zalo (`zalo_info`): [`ZaloBusinessMessageInfo`](https://developers.google.com/google-ads/api/reference/rpc/v26/ZaloBusinessMessageInfo) identified by `oa_id` or `custom_name`.
  - For LINE (`line_info`): [`LineBusinessMessageInfo`](https://developers.google.com/google-ads/api/reference/rpc/v26/LineBusinessMessageInfo) identified by `line_id` (must begin with `'@'`).
  - For SMS (`sms_info`): [`SmsBusinessMessageInfo`](https://developers.google.com/google-ads/api/reference/rpc/v26/SmsBusinessMessageInfo) identified by a two-letter `country_code` (such as `'US'`) and `phone_number` (such as `'1234567890'`).
- A welcome [`message`](https://developers.google.com/google-ads/api/reference/rpc/v26/BusinessMessageAsset) (`starter_message`) to prompt the user to initiate a conversation.
- A compelling [`call to action`](https://developers.google.com/google-ads/api/reference/rpc/v26/BusinessMessageCallToActionInfo) that empowers people to engage with your business or service.

> [!NOTE]
> **Note:** Business message assets must comply with [Google Ads policies](https://support.google.com/adspolicy/answer/6008942), including advertiser verification and messaging requirements.

The response will return the [`asset ID`](https://developers.google.com/google-ads/api/reference/rpc/v26/Asset) which you can
use for linking.

## Link a business message asset

You can link business message assets at the account, campaign, or ad group
level. Only one active business message asset with [`status`](https://developers.google.com/google-ads/api/reference/rpc/v26/AssetLinkStatusEnum.AssetLinkStatus)
set to `ENABLED` is allowed for each message provider type at each level.

### Responsive search ads

In a [responsive search ad](https://support.google.com/google-ads/answer/7684791),
when multiple message assets are eligible, the ad uses the asset at the lowest
level in the hierarchy of Customer -\> Campaign -\> AdGroup.