# 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](https://apidocs.nhanh.vn/v3/vpage/marketing/custom_audience_addsubscriber), 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
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 | <p><code>NEW\_USER</code>: 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)<br><code>ALL\_USER</code>: Tất cả khách của tệp segmentIds</p> |
| segmentIds   | array  | Danh sách ID tệp [đối tượng tuỳ chỉnh (Custom Audience)](https://apidocs.nhanh.vn/v3/vpage/marketing/custom_audience_list) hoặc [Chủ đề (Topic)](https://apidocs.nhanh.vn/v3/vpage/marketing/topic_list)                                                                                             |
| 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)](https://apidocs.nhanh.vn/v3/vpage/marketing/topic_list)                                     |
| excludes.audienceIds | array  | Không gửi cho khách trong các tệp [đối tượng tuỳ chỉnh (Custom Audience)](https://apidocs.nhanh.vn/v3/vpage/marketing/custom_audience_list) |
| excludes.campaignIds | array  | Không gửi cho khách đã gửi trong [chiến dịch](https://apidocs.nhanh.vn/v3/vpage/marketing/fmm_campaign_list)                                |

## Response

* Xem cấu trúc chung [tại đây](https://apidocs.nhanh.vn/v3/readme#response).

### Failed response

* Xem các mã lỗi chung [tại đây](https://apidocs.nhanh.vn/v3/readme#failed-response).
* 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

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