scheduled.
Vui lòng xem tổng quan webhook để biết thêm chi tiết.
Sau khi đăng ký một URL webhook, bạn sẽ nhận được yêu cầu POST đến URL của mình khi một sự kiện xảy ra.
Yêu cầu POST sẽ bao gồm một payload JSON với chi tiết sự kiện.
Scheduled Action
Bạn sẽ nhận được thông báo webhook này khi một bài đăng đã lên lịch được xử lý — dù thành công hay thất bại — và được đăng lên các mạng xã hội đã chọn. Ví dụ, nếu bạn lên lịch một bài đăng cho 12:00 PM ngày 1 tháng 8 năm 2026, webhook sẽ được gửi vào chính thời điểm bài đăng được xuất bản. Thông báo webhook chỉ được gửi cho các bài đăng được lên lịch trong tương lai bằng trườngscheduleDate trong endpoint /post.
Scheduled Event
Bạn sẽ không nhận được thông báo webhook cho các bài đăng ngay lập tức, vì API trả về phản hồi thành công hoặc thất bại ngay lập tức trong phản hồi JSON.
Thông báo webhook chỉ được gửi cho các bài đăng đã lên lịch, vì những bài này được xử lý bất đồng bộ và yêu cầu thông báo riêng để thông báo cho bạn về trạng thái của chúng.
TikTok Publishing Webhook
Khi làm việc với TikTok qua Ayrshare, bạn có thể nhận được hai webhook khác nhau cho một bài đăng đã lên lịch. Nếu bài đăng của bạn được lên lịch thay vì đăng ngay lập tức, bạn sẽ nhận được webhook Scheduled Action tiêu chuẩn trước. Điều này cho biết phương tiện đã được gửi thành công đến TikTok để xử lý và đăng. Sau đó, bạn sẽ nhận được webhooksubAction: tikTokPublished.
Điều này được kích hoạt sau khi TikTok đã hoàn thành xử lý phương tiện và phương tiện được công khai.
Webhook này được kích hoạt cho cả bài đăng ngay lập tức và bài đăng đã lên lịch.
Trong bảng điều khiển Ayrshare, sự kiện này được gắn nhãn là tikTok (pub).
Social Action
Thông báo khi profile của người dùng liên kết hoặc hủy liên kết một mạng xã hội.Social Action Event
source là system có nghĩa là Ayrshare tự động hủy liên kết tài khoản, chẳng hạn như khi kết nối mạng xã hội không còn hợp lệ. Chúng tôi khuyến nghị bạn thông báo cho người dùng của mình để họ có thể tiếp tục đăng bài. Chi tiết về việc hủy liên kết được tìm thấy trong trường details. Một email cũng sẽ được gửi đến địa chỉ email của Primary Account, hoặc email thay thế nếu chúng đã được thiết lập.
source là user có nghĩa là người dùng đã tự khởi động hành động, chẳng hạn như họ hủy liên kết tài khoản theo cách thủ công. Email sẽ không được gửi khi xảy ra hành động do người dùng khởi tạo.
Messages Action
Yêu cầu Messaging Add-On để truy cập tất cả các endpoint và webhook messages. Đối với Facebook và Instagram, nhận thông báo khi một tin nhắn trực tiếp đến, được đọc, hoặc có một reaction được tạo hoặc xóa. WhatsApp hiện chỉ gửi thông báo đến URL webhook đã đăng ký của bạn khi một tin nhắn đến mới được lưu trữ. Webhook X/Twitter có sẵn dưới dạng tùy chọn cho khách hàng Enterprise. Vui lòng liên hệ với đại diện tài khoản của bạn để biết thêm thông tin về việc trở thành khách hàng Enterprise. WhatsApp hiện không gửi webhooks reaction hoặc trạng thái chuyển tin tới URL đã đăng ký của bạn. Các tin nhắn đi đã lưu có thể có giá trịstatus là sent, delivered, read, hoặc failed — xem
WhatsApp Message Status bên dưới.
Phạm vi Standby cho Facebook Pages với nhiều ứng dụng
Ayrshare đăng ký trường webhookstandby của Facebook ngoài các trường messaging tiêu chuẩn. Điều này có nghĩa là các sự kiện Messenger được gửi đến webhook của bạn ngay cả khi ứng dụng khác trên cùng Facebook Page hiện đang giữ quyền điều khiển thread — ví dụ, khi nền tảng chatbot được đặt làm primary receiver của Page, hoặc khi Meta’s Page Inbox đang xử lý cuộc trò chuyện.
Không có thay đổi lược đồ cho các sự kiện này. Chúng đến dưới dạng cùng các payload messageCreated / messageRead / reactionCreated / messageEdited được ghi lại trong các phần bên dưới. Hai điều cần lưu ý cho Pages có ứng dụng Messenger cạnh tranh được cài đặt:
- Khối lượng tin nhắn đến có thể tăng so với hành vi trước đây, khi các sự kiện standby được bỏ qua âm thầm trước khi được đăng ký. Lưu lượng mới thể hiện các tin nhắn mà Page của bạn đã nhận được đang được xử lý bởi ứng dụng khác.
- Bạn có thể nhận được sự kiện
messageCreatedvớitype: "sent"không tương ứng với các tin nhắn bạn đã gửi qua Ayrshare. Đây là echo của các tin nhắn được gửi bởi ứng dụng Messenger khác trên Page của bạn (Meta gửi một bản sao của mỗi lần gửi đến mỗi ứng dụng đã đăng ký). Nếu tích hợp của bạn đối chiếu lưu lượng đi với lịch sử gửi riêng của mình, bạn có thể sử dụng lịch sử đó để phân biệt các lần gửi của mình với các lần gửi của ứng dụng cạnh tranh.
New Message Events
Thông báo khi một tin nhắn mới được gửi hoặc nhận.Message Read Event
Thông báo khi một tin nhắn được đọc bởi người nhận.mid xác định duy nhất tin nhắn cụ thể nào đã được đọc.
Đối với tin nhắn Facebook, việc đọc tin nhắn được theo dõi ở cấp cuộc trò chuyện bằng cách sử dụng conversationId.
Khi sự kiện đọc xảy ra, tất cả các tin nhắn trong cuộc trò chuyện đó với dấu thời gian trước dấu thời gian created (hoặc read) nên được coi là đã được đọc bởi người dùng.
Reaction Created and Deleted Events
Thông báo khi một reaction, chẳng hạn như like, được tạo hoặc xóa trên một tin nhắn.Message Edit Event
Thông báo khi người dùng chỉnh sửa một tin nhắn họ đã gửi trước đó. Có sẵn cho tin nhắn trực tiếp Facebook và Instagram. TrườngmessageEdit.mid khớp với id của sự kiện messageCreated gốc, để người tiêu dùng có thể tương quan chỉnh sửa với tin nhắn gốc. Trường messageEdit.text mang văn bản tin nhắn mới đã chỉnh sửa.
WhatsApp Message Status
WhatsApp theo dõi trạng thái chuyển tin của từng tin nhắn trên các tin nhắn đi đã lưu bằng một trườngstatus duy nhất:
sent, delivered, read, hoặc failed. Các cập nhật này hiện không được gửi tới URL webhook
đã đăng ký của bạn dưới dạng các sự kiện riêng biệt. Nếu bạn cần trạng thái chuyển tin theo thời gian thực, vui lòng
liên hệ với đại diện tài khoản Ayrshare của bạn.
Batch Action
Thông báo khi một batch đã hoàn thành xử lý và tệp có sẵn, chẳng hạn như lấy tất cả user profile. Bạn có thể truy cập tệp bằng URL pre-signed trong trườngurl.
Batch Event
Feed Action
Thông báo khi một mục RSS feed mới được tìm thấy cho các RSS feed đã đăng ký. Lưu ý: nếu Webhook đang hoạt động, các mục RSS mới sẽ không được tự động đăng lên các mạng xã hội.Feed Event
Mentions Action
Thông báo khi tài khoản đã kết nối của bạn được nhắc đến. Có sẵn cho Facebook và Instagram.Đối với Instagram, đăng ký webhook
mentions là tất cả những gì cần thiết để nhận các sự kiện nhắc đến. Messaging Add-On, việc kích hoạt messaging và việc kết nối lại tài khoản mạng xã hội là không cần thiết.action, refId, hookId, url, và timeStamp với Webhook Security) và subAction. Ví dụ dưới đây có hình dạng Instagram: media_id, cộng với comment_id khi mention nằm trong một bình luận. Các mention Các sự kiện nhắc đến Trang Facebook hiện không được gửi — Ayrshare xác nhận chúng với Meta và không chuyển tiếp tới webhook của bạn. Hiện chỉ các lượt nhắc đến Instagram được gửi.
Mention Event (Instagram)
Comments Action
Thông báo khi một bình luận được tạo trên nội dung đã kết nối của bạn. Có sẵn cho Facebook và Instagram.Đối với Instagram, đăng ký webhook
comments là tất cả những gì cần thiết để nhận các sự kiện bình luận. Messaging Add-On, việc kích hoạt messaging và việc kết nối lại tài khoản mạng xã hội là không cần thiết.action, refId, hookId, url, và timeStamp với Webhook Security) và subAction. Ví dụ dưới đây có hình dạng Instagram. Các bình luận Facebook đến dưới dạng một thay đổi feed Page với tên trường khác (ví dụ comment_id, post_id, message, và from.name); hãy tham khảo tài liệu tham khảo webhooks của Meta để biết bộ trường Facebook.
Comment Event (Instagram)
Automations Action
Thông báo khi một automation kích hoạt một hành động webhook cho người dùng, chẳng hạn như trình kích hoạt trả lời tự động comment hoặc DM.Automation Event
Demo Action
Thông báo cho các sự kiện vòng đời của Demo User Profile. Demo User Profile khả dụng trên Enterprise plan; vui lòng liên hệ với chúng tôi nếu bạn muốn tìm hiểu thêm. Hai loại sự kiện được gửi trên actiondemo, được phân biệt bằng trường type:
upgradeWarning— được gửi hai ngày trước khi Demo User Profile tự động chuyển thành User Profile tiêu chuẩn, để bạn có thể nhắc người dùng của mình tiếp tục hoặc xóa profile.upgrade— được gửi khi việc chuyển đổi xảy ra.
