Tổng quan về Automations API

​

Cách hoạt động

​

Trigger

​

Quy tắc evergreen với "all"

{
  "type": "comment_keyword",
  "postId": "all",
  "keywords": ["LINK", "INFO"]
}

​

Trang Facebook

• Trigger: dm_keyword và dm_reaction. Các trigger bình luận và story hiện chỉ dành cho Instagram, và một automation Facebook sử dụng một trong số đó sẽ bị từ chối với lỗi xác thực dữ liệu.
• Messaging: profile cần kích hoạt Messaging cho Facebook, giống như khi gửi một DM Facebook bằng Messages API.
• Người nhận: {{recipient_id}} là ID theo phạm vi Trang (PSID) của người dùng. {{recipient_username}} để trống, vì webhook của Messenger không bao gồm tên người dùng.

{
  "platform": "facebook",
  "name": "Price list on request",
  "triggers": [{ "type": "dm_keyword", "keywords": ["price"] }],
  "actions": [{ "type": "send_dm", "message": "Here is our price list: https://example.com/prices" }]
}

​

Action

​

Cửa sổ dedup theo action

• Đặt thành 0 để vô hiệu hóa dedup hoàn toàn cho action đó (điển hình cho fire_webhook / send_email nơi người nhận mong đợi mọi sự kiện).
• Giới hạn tối đa ở 525600 (một năm).

{
  "type": "send_dm",
  "message": "Thanks {{recipient_username}}!",
  "dedupWindowMinutes": 1440
}

​

Nội dung tin nhắn động

1. Chúng tôi POST thông tin chi tiết tới messageUrl của bạn: ai đã bình luận ("recipientUsername": "ava"), họ đã viết gì, và bình luận nằm trên bài đăng nào.
2. Máy chủ của bạn viết một câu trả lời cho Ava, ví dụ kèm một liên kết theo dõi được tạo riêng cho cô ấy, và trả về { "message": "Hi ava, here's your link: https://example.com/r/12345" }.
3. Chúng tôi gửi văn bản đó tới Ava dưới dạng DM, đúng như bạn đã viết.

{
  "type": "send_dm",
  "messageUrl": "https://yourapp.example.com/automations/message",
  "timeoutMs": 3000,
  "message": "Thanks for commenting! Here is the link: https://example.com"
}

{
  "automationId":      "auto_9xKp2Lm4nQ",
  "triggerId":         "trg_a1b2c3",
  "trigger":           "comment_keyword",
  "platform":          "instagram",
  "recipientId":       "17841401234567890",
  "recipientUsername": "ava",
  "keyword":           "LINK",
  "activityId":        "auto_9xKp2Lm4nQ:trg_a1b2c3:comment.received:17912345678901234",
  "actionId":          "act_dm_1",
  "eventId":           "comment.received:17912345678901234",
  "commentId":         "17912345678901234",
  "commentText":       "LINK please!",
  "postId":            "17998765432109876",
  "storyId":           null,
  "timestamp":         "2026-05-12T09:14:22.000Z",
  "timeStamp":         1778577262
}

{ "message": "Hi ava — grabbed that link for you: https://example.com/r/12345" }

​

Sự kiện webhook

​

automation.triggered

{
  "type":              "automation.triggered",
  "automationId":      "auto_9xKp2Lm4nQ",
  "triggerId":         "trg_a1b2c3",
  "trigger":           "comment_keyword",
  "platform":          "instagram",
  "recipientId":       "17841401234567890",
  "recipientUsername": "jane_doe",
  "keyword":           "LINK",
  "activityId":        "auto_9xKp2Lm4nQ:trg_a1b2c3:comment.received:17912345678901234",
  "actionId":          "act_wh_1",
  "eventId":           "comment.received:17912345678901234",
  "commentId":         "17912345678901234",
  "commentText":       "LINK please",
  "postId":            "17895695668004550",
  "storyId":           null,
  "timestamp":         "2026-05-12T09:14:22.000Z"
}

​

automation.completed

{
  "type": "fire_webhook",
  "sendCompletedEvent": true
}

{
  "type":         "automation.completed",
  "automationId": "auto_9xKp2Lm4nQ",
  "triggerId":    "trg_a1b2c3",
  "trigger":      "comment_keyword",
  "platform":     "instagram",
  "recipientId":  "17841401234567890",
  "activityId":   "auto_9xKp2Lm4nQ:trg_a1b2c3:comment.received:17912345678901234",
  "eventId":      "comment.received:17912345678901234",
  "status":       "sent",
  "actionResults": [
    { "actionId": "act_dm_1", "type": "send_dm",      "status": "sent", "errorDetails": null, "messageSource": "callback" },
    { "actionId": "act_wh_1", "type": "fire_webhook", "status": "sent", "errorDetails": null }
  ],
  "errorDetails": null,
  "timestamp":    "2026-05-12T09:14:58.000Z"
}

​

Nếu không có webhook nào được đăng ký

​

Biến template

Hey {{recipient_username}}, thanks for the comment "{{comment_text}}" — here is the link you wanted: https://example.com

​

Giới hạn tốc độ và giới hạn

​

Trạng thái Activity

​

Mã lỗi

• Lỗi quy tắc kinh doanh mang một code automation được đánh số (ví dụ: { "action": "automation", "code": 469, ... }).
• Lỗi validation — bất kỳ body yêu cầu bị lỗi định dạng nào (trường thiếu hoặc không hợp lệ, biến template không xác định, khóa không được nhận dạng) — được trả về dưới dạng một phản hồi 473 duy nhất với đối tượng details liệt kê các trường vi phạm. details là kết quả của validator (formErrors cộng với fieldErrors). Phân nhánh trên details, không phải trên mã theo điều kiện. Trong fieldErrors, các khóa là các trường yêu cầu cấp cao nhất (triggers, actions): một vấn đề bên trong một mục cụ thể, chẳng hạn như một trigger thiếu keywords, được báo cáo dưới trường đó (ví dụ: triggers), trong khi formErrors giữ các vấn đề cấp đối tượng như các khóa không được nhận dạng.

​

Những gì Meta KHÔNG cho phép

• Tự động DM cho người theo dõi mới. Instagram không xuất bản một webhook follow.
• DM tin nhắn đầu tiên cho người lạ. Meta yêu cầu người nhận phải tương tác trước (bình luận, trả lời, DM, phản ứng) trước khi một tài khoản doanh nghiệp có thể nhắn tin cho họ. Mọi trigger được hỗ trợ đều được neo vào một tương tác như vậy — nhưng lưu ý rằng được phép gửi không đồng nghĩa với việc tin nhắn được chuyển: thiết lập Message requests trên Instagram của người nhận vẫn có thể khiến Meta chấp nhận rồi âm thầm loại bỏ tin nhắn (xem Automation DM đã Gửi nhưng Không được Chuyển).
• Chiến dịch gửi hàng loạt. Giới hạn DM theo giờ và heuristic chống lạm dụng áp dụng ở cấp nền tảng.

​

Sử dụng đa profile

​

Câu hỏi thường gặp

​

Endpoint

• POST /automations — tạo một automation mới
• GET /automations — liệt kê các automation của bạn
• GET /automations/:id — lấy một automation với các trigger và action của nó
• PUT /automations/:id — cập nhật một phần; tạm dừng qua active: false
• DELETE /automations/:id — soft-delete
• GET /automations/:id/activity — nhật ký kiểm toán điều phối được phân trang theo cursor