Hướng dẫn này giải thích cách tạo và đăng quảng cáo Click đến WhatsApp bằng API Marketing.
Khi nhấp vào quảng cáo click đến WhatsApp, người dùng sẽ được chuyển thẳng đến cuộc trò chuyện với doanh nghiệp của bạn trên WhatsApp. Hãy sử dụng những quảng cáo này để tiếp cận mọi người trên quy mô lớn và cung cấp dịch vụ nổi bật, dành riêng cho từng cá nhân.
Quảng cáo click đến WhatsApp hỗ trợ quảng cáo có chứa hình ảnh, video, thẻ quay vòng hoặc bản trình chiếu. Bạn cũng có thể thêm gợi ý gọi điện vào quảng cáo của mình.
Nếu bạn muốn tạo quảng cáo chuyển người dùng đến đoạn chat trên Messenger hoặc Instagram, hãy xem hướng dẫn trong bài viết Quảng cáo click đến Messenger hoặc Quảng cáo click đến Instagram. Bạn cũng có thể tạo quảng cáo chọn đích đến mà người dùng có nhiều khả năng sẽ phản hồi nhất, hãy xem bài viết Quảng cáo click đến nhiều đích đến để biết thêm thông tin.
Tài liệu này trình bày các bước bạn cần thực hiện để thiết lập tiện ích tích hợp cho quảng cáo click đến WhatsApp.
Bạn sẽ cần:
Hướng dẫn này giả định rằng bạn:
Để thực hiện lệnh gọi thành công đến mọi điểm cuối trong hướng dẫn này, bạn sẽ cần có:
ads_management
pages_manage_ads
pages_read_engagement
pages_show_list
Bắt đầu bằng cách tạo chiến dịch quảng cáo. Để thực hiện, hãy gửi yêu cầu POST
đến điểm cuối /act_<AD_ACCOUNT_ID>/campaigns
, trong đó <AD_ACCOUNT_ID>
là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
enum | Bắt buộc. |
danh sách<Object> | Bắt buộc. |
enum | Không bắt buộc. |
curl -X POST \
-F 'name=Click to WhatsApp Campaign' \
-F 'objective=OUTCOME_ENGAGEMENT' \
-F 'status=ACTIVE' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
curl -X POST \
-F 'name=Click to WhatsApp Calling Campaign' \
-F 'objective=OUTCOME_ENGAGEMENT' \
-F 'status=PAUSED' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON chứa ID của chiến dịch bạn mới tạo.
{ "id": "<AD_CAMPAIGN_ID>" }
Bạn có thể cập nhật chiến dịch bằng cách gửi yêu cầu POST
đến /<AD_CAMPAIGN_ID>
.
Để xác minh rằng bạn đã tạo thành công chiến dịch click đến WhatsApp, bạn có thể gửi yêu cầu GET
đến /<AD_CAMPAIGN_ID>
. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về Chiến dịch quảng cáo.
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_CAMPAIGN_ID>
{ "name": "Click to WhatsApp Campaign", "status": "PAUSED", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_CAMPAIGN_ID>" }
Sau khi bạn tạo chiến dịch quảng cáo, hãy tạo nhóm quảng cáo. Để tạo nhóm quảng cáo, hãy gửi yêu cầu POST
đến điểm cuối /act_<AD_ACCOUNT_ID>/adsets
, trong đó <AD_ACCOUNT_ID>
là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:
Tên | Mô tả |
---|---|
int32 không dấu | Bắt buộc nếu bạn đặt bid_strategy là |
enum | Không bắt buộc. |
enum | Bắt buộc. |
chuỗi số hoặc số nguyên | Bắt buộc. |
int64 | Bắt buộc nếu bạn không đặt |
chuỗi | Bắt buộc. |
datetime | Bắt buộc khi bạn chỉ định |
int64 | Bắt buộc nếu bạn không đặt |
chuỗi | Bắt buộc. |
enum | Bắt buộc.
|
| Bắt buộc. Bắt buộc:
Không bắt buộc:
Hãy xem bài viết Nhóm quảng cáo, đối tượng được quảng cáo để biết thêm chi tiết. |
datetime | Không bắt buộc. |
enum | Không bắt buộc. |
Đối tượng nhắm mục tiêu | Bắt buộc. |
datetime | Không bắt buộc. |
datetime | Bắt buộc khi bạn chỉ định |
Hãy truy cập vào tài liệu tham khảo về Nhóm quảng cáo của tài khoản quảng cáo để xem danh sách đầy đủ các thông số có thể sử dụng.
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"access_token":"<ACCESS_TOKEN>",
"bid_amount":"<BID_AMOUNT>",
"billing_event":"IMPRESSIONS",
"campaign_id":"<CAMPAIGN_ID>",
"daily_budget":"<DAILY_BUDGET>",
"destination_type":"WHATSAPP",
"name": "<AD_SET_NAME>",
"optimization_goal": "IMPRESSIONS",
"promoted_object": {
"page_id": "<PAGE_ID>"
},
"status": "PAUSED",
"start_time": "<START_TIME>",
"targeting": {
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"]
}
}' \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adsets"
{ "id": "<AD_SET_ID>" }
Bạn có thể cập nhật nhóm quảng cáo bằng cách gửi yêu cầu POST
đến /<AD_SET_ID>
.
Để xác minh rằng bạn đã tạo thành công nhóm quảng cáo click đến WhatsApp, bạn có thể gửi yêu cầu GET
đến /<AD_SET_ID>
. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về Nhóm quảng cáo.
curl -X GET -G \
-d 'fields=name,destination_type,optimization_goal,bid_strategy,status' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_SET_ID>
{ "name": "Click to WhatsApp Campaign", "status": "PAUSED", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_SET_ID>" }
Với nội dung quảng cáo, bạn có thể thêm các tài sản vào quảng cáo của mình. Để tạo nội dung quảng cáo, hãy gửi yêu cầu POST
đến điểm cuối /act_<AD_ACCOUNT_ID>/adcreatives
, trong đó <AD_ACCOUNT_ID>
là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
| Bắt buộc. Bắt buộc:
Không bắt buộc:
|
| Không bắt buộc. |
Hãy truy cập vào tài liệu tham khảo về Nội dung quảng cáo để xem danh sách đầy đủ các thông số có thể sử dụng.
Tin nhắn mặc định mà khách hàng nhìn thấy là "Xin chào! Cho mình xin thêm thông tin được không?". Bạn có thể tạo trải nghiệm người dùng phù hợp hơn cho quảng cáo click đến WhatsApp bằng cách tùy chỉnh tin nhắn chào của quảng cáo trong trường page_welcome_message
thuộc phần object_story_spec
.
Lưu ý: Nếu bạn đang sử dụng tin nhắn WhatsApp để kích hoạt quy trình bot bất kỳ, hãy đảm bảo cập nhật thông tin này cùng BSP và agency của bạn để quy trình đó không bị gián đoạn.
Thêm tin nhắn tự động điền kèm theo tin nhắn chào
"page_welcome_message": { "type": "VISUAL_EDITOR", "version": 2, "landing_screen_type": "welcome_message", "media_type": "text", "text_format": { "customer_action_type": "autofill_message", "message": { "autofill_message": { "content": "<AUTOFILL_MESSAGE>" }, "text": "<GREETING_MESSAGE>" } } }
"page_welcome_message": { "type": "VISUAL_EDITOR", "version": 2, "landing_screen_type": "welcome_message", "media_type": "text", "text_format": { "customer_action_type": "ice_breakers", "message": { "text": "<GREETING_MESSAGE>", "ice_breakers": [ { "title": "<ICEBREAKER>" }, { "title": "<ICEBREAKER>" }, { "title": "<ICEBREAKER>" } ] } } } }
curl \
-F 'object_story_spec={
"page_id": "<PAGE_ID>"
"link_data": {
"image_hash":<IMAGE_HASH>
"call_to_action": {
"type": "WHATSAPP_MESSAGE",
"value": {
"app_destination": "WHATSAPP"
}
},
"link": "https://api.whatsapp.com/send",
"name": <AD_HEADLINE>",
"page_welcome_message":
"type": "VISUAL_EDITOR",
"version": 2,
"landing_screen_type": "ctwa_call_prompt",
"media_type": "text",
"text_format": {
"message": {
"text": "<MESSAGE>"",
"call_prompt_data": {
"call_prompt_message": "<CALL_PROMPT_MESSAGE>"
}
}
},
"user_edit": false
},
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
{ "id": "<AD_CREATIVE_ID>" }
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"name": "Sample ad creative",
"object_story_spec": {
"page_id": "<PAGE_ID>",
"link_data": {
"name": "<AD_HEADLINE>",
"message": "<AD_PRIMARY_TEXT>",
"description": "<AD_DESCRIPTION>",
"image_hash": "<IMAGE_HASH>",
"link": "https://api.whatsapp.com/send",
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "WHATSAPP_MESSAGE",
"value": {
"app_destination": "WHATSAPP"
}
}
}
},
"degrees_of_freedom_spec": {
"creative_features_spec": {
"standard_enhancements": {
"enroll_status": "OPT_IN"
}
}
}
}' \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives"
Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON chứa ID của nội dung quảng cáo bạn mới tạo.
{ "id": "<AD_CREATIVE_ID>" }
Bạn cũng có thể sử dụng nội dung hiện có trên Instagram để tạo nội dung quảng cáo.
curl -X POST \ -H "Content-Type: application/json" \ -d '{ "source_instagram_media_id": "<INSTAGRAM_MEDIA_ID>", "instagram_user_id": "<INSTAGRAM_USER_ID>", "object_id": "<PAGE_ID>", "call_to_action": { "type": "WHATSAPP_MESSAGE", "value": { "link": "https://api.whatsapp.com/send", "app_destination": "WHATSAPP" } } }, "degrees_of_freedom_spec": { "creative_features_spec": { "standard_enhancements": { "enroll_status": "OPT_IN" } } } }' \ https://graph.facebook.com/latest-api-version />/act_<AD_ACCOUNT_ID>/adcreatives
Bạn có thể cập nhật nội dung quảng cáo bằng cách gửi yêu cầu POST
đến /<AD_CREATIVE_ID>
.
Để xác minh rằng mình đã tạo thành công nội dung quảng cáo click đến WhatsApp, bạn có thể gửi yêu cầu GET
đến /<AD_CREATIVE_ID>
. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong bài viết Nội dung quảng cáo.
curl -X GET -G \
-d 'fields=name,object_story_spec{link_data{call_to_action,page_welcome_message}}' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_CREATIVE_ID>
{ "name": "Sample ad creative", "object_story_spec" { "page_welcome_message": { "type": "VISUAL_EDITOR", "version": 2, "landing_screen_type": "welcome_message", "media_type": "text", "text_format": { "customer_action_type": "autofill_message", "message": { "autofill_message": { "content": "Sample autofill message" }, "text": "Sample greeting message" } } } }, "id": "<AD_CREATIVE_ID>" }
Quảng cáo giúp bạn liên kết thông tin về nội dung quảng cáo với nhóm quảng cáo của mình. Để tạo quảng cáo, hãy gửi yêu cầu POST
đến điểm cuối /act_<AD_ACCOUNT_ID>/ads
, trong đó <AD_ACCOUNT_ID>
là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
chuỗi số hoặc số nguyên | Bắt buộc. |
| Bắt buộc. |
enum | Bắt buộc. |
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"name": "Sample ad",
"adset_id": "<AD_SET_ID>",
"creative": {
"creative_id": "<AD_CREATIVE_ID>"
},
"status": "PAUSED"
}' \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads"
{ "id": "<AD_ID>" }
Bạn có thể cập nhật quảng cáo bằng cách gửi yêu cầu POST
đến /<AD_ID>
.
Để xác minh rằng mình đã tạo thành công quảng cáo click đến WhatsApp, bạn có thể gửi yêu cầu GET
đến /<AD_ID>
. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về quảng cáo.
curl -X GET -G \
-d 'fields=status,adset_id,campaign_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_ID>
{ "status": "PAUSED", "adset_id": "<AD_SET_ID>", "campaign_id": "<AD_CAMPAIGN_ID>", "id": "<AD_ID>" }
Xác minh rằng quảng cáo của bạn tồn tại trong Trình quản lý quảng cáo. Khi bạn đã sẵn sàng đăng các thay đổi, hãy chọn chiến dịch của bạn, nhóm quảng cáo cho chiến dịch đó và quảng cáo rồi nhấp vào nút Đăng.
Bạn cũng có thể đăng quảng cáo bằng API. Bạn chỉ cần gửi yêu cầu POST
đến /<AD_ID>
và đặt thông số status
là ACTIVE
, trong đó <AD_ID>
là quảng cáo mà bạn muốn đăng.
Meta sẽ xét duyệt quảng cáo của bạn và trạng thái sẽ là PENDING_REVIEW
. Sau khi được phê duyệt, trạng thái sẽ tự động cập nhật thành ACTIVE
và hệ thống sẽ phân phối quảng cáo của bạn.