Gửi lại một chiến dịch Facebook Marketing Message

• API này cho phép gửi lại một chiến dịch tin nhắn quảng cáo đã gửi thành công trước đó.

• Một số tình huống hay sử dụng:

  • Tình huống 1: Bạn có 1 chiến dịch gửi tin đã gửi thành công, nay muốn gửi lại tin cho toàn bộ khách hàng với nội dung cũ, thì bạn có thể dùng lại chiến dịch này, thay vì phải tạo chiến dịch mới và chờ Facebook duyệt nội dung, giúp rút ngắn thời gian chờ.

  • Tình huống 2: Bạn thêm khách vào tệp đối tượng tùy chỉnh, sau đó muốn gửi tin cho các khách mới được thêm vào tệp này (Tính năng này chỉ phù hợp cho các chiến dịch chạy dài ngày).

• Chú ý:

  • Facebook giới hạn mỗi user chỉ được nhận 1 tin nhắn quảng cáo trong vòng 12h, nếu bạn vi phạm quy định này, page của bạn có thể sẽ bị khóa tính năng gửi Marketing Message.

  • Vpage sẽ tự động chặn việc bạn gửi spam quá nhiều bằng cách loại trừ các user token đã nhận được tin trong vòng 12h gần nhất. Cơ chế này chỉ hoạt động được khi bạn chỉ sử dụng Vpage để gửi tin, nếu bạn dùng thêm 1 app khác, Vpage không thể đảm bảo được việc này.

Request

curl --location 'https://vpage.open.nhanh.vn/v3.0/marketing/fmmcampaignresend?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--data '{
  "campaign": {
    "adCampaignId": "120232711406030373",
    "sendMode": "NEW_USER",
    "segmentIds": [],
    "sendAt": 1761294919,
  },
  "settings": {
    "noResendWithinDays": 1,
    "excludes": {
      "topicsIds": [],
      "audienceIds": [],
      "campaignIds": []
    }
  }
}'

campaign

Key	Type	Description
adCampaignId	string	ID chiến dịch trên Facebook đã gửi trên Vpage
sendMode	string	NEW_USER: Chỉ gửi cho các khách chưa từng nhận được tin nhắn của campaign này (VD: Khách mới upload lên tệp khách hàng, hoặc khách lần trước chưa gửi được do hết ngân sách, hết ngày chạy chiến dịch chưa gửi được) ALL_USER: Tất cả khách của tệp segmentIds
segmentIds	array	Danh sách ID tệp đối tượng tuỳ chỉnh (Custom Audience) hoặc Chủ đề (Topic)
sendAt	number	Thời gian gửi dự kiến (UNIX timestamp).

settings

Key	Type	Description
noResendWithinDays	number	Không gửi cho khách đã nhận tin trong vòng x ngày gần nhất.
excludes.topicsIds	array	Không gửi cho khách đã đăng ký Chủ đề (Topic)
excludes.audienceIds	array	Không gửi cho khách trong các tệp đối tượng tuỳ chỉnh (Custom Audience)
excludes.campaignIds	array	Không gửi cho khách đã gửi trong chiến dịch

Response

• Xem cấu trúc chung tại đây.

Failed response

• Xem các mã lỗi chung tại đây.

• Danh sách errorCode của riêng API này:

errorCode	Description
ERR_FMM_INVALID_EXCLUDE_SEGMENT_IDS	Sai điều kiện loại trừ tệp. VD bạn đang chọn gửi tin cho tệp A, nhưng lại chọn loại trừ chính tệp A này

Successful response

{
  "code": 1,
  "data": {
      "adCampaignId": "(string) Id of Facebook Marketing Message campaign",
  }
}