Tương tác

Ngoài việc đăng bài, MADIAD Hub cho phép bạn tương tác với khán giả mà một Profile đã xây dựng, liệt kê media gần đây, đọc và trả lời bình luận, gửi tin nhắn trực tiếp, và chạy AutoDM monitor tự động phản hồi người mới bình luận. Mọi lệnh gọi đều giới hạn theo một Profile của bạn qua profile_id.

Để tự động để lại bình luận của chính bạn ngay khi bài đăng lên (gắn link hay hashtag), hãy dùng field first_comment của bài đăng thay vào đó. Đó là một phần của việc đăng bài, không phải engagement.

Trả lời và kiểm duyệt bình luận có từ gói Starter trở lên. Nhắn tin riêng và AutoDM monitor có từ gói Business trở lên, và mỗi gói có hạn mức DM theo ngày, vượt sẽ trả về 429. Yêu cầu ở gói không bao gồm tính năng trả về 403.

Thao tác	Gói cần có
Đọc bình luận, liệt kê media	Mọi gói đang hoạt động
Trả lời công khai dưới bình luận	Starter trở lên
Viết bình luận mới, xoá bình luận	Starter trở lên
Ẩn / thích / ghim bình luận	Starter trở lên
Nhắn riêng cho người bình luận	Business trở lên
Gửi tin nhắn trực tiếp, chạy AutoDM monitor	Business trở lên
Trả lời đánh giá Google	Business trở lên

Gói Chưa kích hoạt không có thao tác ghi nào. Muốn biết gói hiện tại của bạn có gì, đọc GET /v1/usage: comments.included cho phần bình luận, direct_messages.included cho phần nhắn tin và đánh giá.

Tin nhắn trực tiếp và AutoDM cũng chịu giới hạn nhắn tin riêng của từng nền tảng (ví dụ cửa sổ thời gian của Instagram để nhắn cho người chưa nhắn cho bạn gần đây). Khi một nền tảng từ chối gửi, lý do sẽ hiện trong phản hồi.

Liệt kê media gần đây

Lấy các bài đăng, reel và video gần đây trên các tài khoản đã kết nối của một Profile, hữu ích để tìm media_id cần đọc bình luận.

curl "https://api.madiad.com/v1/engagement/media?profile_id=$PROFILE_ID&platform=instagram" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Danh sách này được phân giải theo TÀI KHOẢN đã kết nối, không theo Profile. Nếu tài khoản Facebook (hoặc LinkedIn) bạn kết nối quản nhiều Page, endpoint trả về Page mặc định của tài khoản đó, không phải Page của Profile bạn hỏi. Đo ngày 04/09/2026. Instagram và Threads lọc đúng.Bạn chỉ thấy được những Page mà tài khoản của chính bạn quản, không bao giờ thấy dữ liệu của khách hàng khác. Nhưng nếu tài khoản của bạn quản nhiều Page, hãy kiểm tra id chủ sở hữu của từng mục trước khi dùng. Phản hồi có kèm trường scope_warning nhắc lại điều này.Cần số liệu bài đăng đúng theo Profile thì dùng GET /v1/analytics/posts.

Bình luận

Kênh áp dụng khi đọc bình luận: Instagram · Facebook · YouTube · LinkedIn · TikTok. Threads, X, Pinterest, Reddit, Bluesky, Google Business và các kênh credential chưa có.

Đọc bình luận của một bài. Truyền platform và xác định bài bằng post_id (media id từ danh sách ở trên) hoặc post_url:

curl "https://api.madiad.com/v1/engagement/comments?profile_id=$PROFILE_ID&platform=instagram&post_id=$MEDIA_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Trả lời công khai dưới một bình luận, hoặc gửi DM riêng cho người bình luận:

# Trả lời công khai
curl -X POST https://api.madiad.com/v1/engagement/comments/public-reply \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "comment_id": "'$COMMENT_ID'", "message": "Cảm ơn bạn đã xem!" }'

# Trả lời bằng DM riêng
curl -X POST https://api.madiad.com/v1/engagement/comments/reply \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "comment_id": "'$COMMENT_ID'", "message": "Đã gửi link cho bạn qua DM 👀" }'

Cả hai đều cần profile_id, comment_id, và message.

Tin nhắn trực tiếp

Kênh áp dụng: chỉ Instagram. DM và AutoDM chưa mở trên kênh nào khác.

Gửi DM cho một người dùng theo id riêng của nền tảng, và liệt kê các cuộc hội thoại hiện có. Cả hai đều cần platform:

curl -X POST https://api.madiad.com/v1/engagement/dms/send \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "instagram", "recipient_id": "17841400000000000", "message": "Chào bạn! Đây là mã giảm giá." }'

curl "https://api.madiad.com/v1/engagement/dms/conversations?profile_id=$PROFILE_ID&platform=instagram" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

AutoDM monitor

Một AutoDM monitor theo dõi một bài đăng và tự động DM bất kỳ ai bình luận, có thể chỉ khi bình luận chứa một từ khóa kích hoạt.

AutoDM monitor chỉ hỗ trợ Instagram, dùng Private Replies API chính thức của Meta. Monitor chạy nền và tự động khử trùng lặp người bình luận, nên mỗi người chỉ được nhắn một lần.

curl -X POST https://api.madiad.com/v1/autodm/monitors \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "'$PROFILE_ID'",
    "post_url": "https://www.instagram.com/p/abc123/",
    "reply_message": "Đây là link bạn cần: https://madiad.com/offer",
    "trigger_keywords": ["link", "info"]
  }'

Phản hồi trả về một monitor_id. Quản lý monitor bằng id đó:

Hành động	Yêu cầu
Trạng thái	`GET /v1/autodm/monitors/{monitor_id}`
Log hoạt động	`GET /v1/autodm/monitors/{monitor_id}/logs`
Tạm dừng	`POST /v1/autodm/monitors/{monitor_id}/pause`
Tiếp tục	`POST /v1/autodm/monitors/{monitor_id}/resume`
Dừng	`POST /v1/autodm/monitors/{monitor_id}/stop`
Xóa	`DELETE /v1/autodm/monitors/{monitor_id}`

Field	Bắt buộc	Mô tả
`profile_id`	có	Profile có tài khoản kết nối chạy monitor.
`post_url`	có	Bài đăng cần theo dõi.
`reply_message`	có	DM gửi cho mỗi người mới bình luận.
`trigger_keywords`	không	Chỉ DM người bình luận có chứa một trong các từ khóa này.
`monitoring_interval`	không	Số phút giữa các lần kiểm tra.

Kiểm duyệt bình luận

Ngoài trả lời, bạn có thể viết, xoá và ẩn / thích / ghim bình luận trên bài của chính mình.

Cả ba đều là thao tác ghi bình luận, có từ gói Starter trở lên. Đọc bình luận thì mọi gói đang hoạt động đều dùng được.

Viết bình luận

Kênh	Bình luận mới	Trả lời	Ghi chú
Facebook	✅	✅
YouTube	✅	✅	`post_id` là id video
LinkedIn	✅	✅	`post_id` là post URN
TikTok	✅	✅	`post_id` (id video) luôn bắt buộc
Instagram	❌	✅	Chỉ trả lời, phải có `comment_id`

Truyền comment_id để trả lời công khai dưới bình luận đó. Truyền post_id hoặc post_url để viết bình luận mới ở cấp cao nhất.

curl -X POST https://api.madiad.com/v1/engagement/comments/create \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "facebook", "post_id": "'$POST_ID'", "message": "Cảm ơn cả nhà đã ghé." }'

Instagram chỉ cho trả lời, không cho mở một luồng bình luận mới, nên phải có comment_id. TikTok luôn cần post_id (id video), kể cả khi đang trả lời một bình luận. Cả hai luật này được kiểm tại chỗ và trả về 400 kèm lý do, thay vì để nền tảng từ chối.

Xoá bình luận

Kênh	Xoá	Ghi chú
Facebook · YouTube · Instagram	✅	Chỉ cần `comment_id`
LinkedIn	✅	Cần thêm `post_id` (post URN)
TikTok	✅	Chỉ xoá được bình luận do chính tài khoản viết

curl -X POST https://api.madiad.com/v1/engagement/comments/delete \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "facebook", "comment_id": "'$COMMENT_ID'" }'

Riêng LinkedIn cần thêm post_id (post URN). Xoá là không hoàn tác được trên nền tảng.

Ẩn, thích, ghim

Kênh	Trạng thái
TikTok	✅ dùng được
Mọi kênh khác	❌ trả `400` `platform_not_supported`

Mỗi hành động mang sẵn hành động ngược của nó. Bạn gửi động từ, không gửi giá trị đúng/sai, nên gửi lại một yêu cầu không bao giờ lật ngược trạng thái.

`action`	Cần `post_id`?
`hide` · `unhide` · `pin` · `unpin`	Có
`like` · `unlike`	Không

curl -X POST https://api.madiad.com/v1/engagement/comments/action \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "tiktok", "comment_id": "'$COMMENT_ID'", "post_id": "'$VIDEO_ID'", "action": "pin" }'

Hiện chỉ TikTok trả lời nhóm này. Nền tảng khác trả 400 với error_code platform_not_supported kèm danh sách nền tảng đang hỗ trợ. Hãy rẽ nhánh theo mã lỗi, đừng gắn cứng danh sách trong mã của bạn.

Bắt đầu

Khái niệm

Tích hợp

Tham chiếu API

Liệt kê media gần đây

Bình luận

Tin nhắn trực tiếp

AutoDM monitor

Kiểm duyệt bình luận

Viết bình luận

Xoá bình luận

Ẩn, thích, ghim

​Liệt kê media gần đây

​Bình luận

​Tin nhắn trực tiếp

​AutoDM monitor

​Kiểm duyệt bình luận

​Viết bình luận

​Xoá bình luận

​Ẩn, thích, ghim

Liệt kê media gần đây

Bình luận

Tin nhắn trực tiếp

AutoDM monitor

Kiểm duyệt bình luận

Viết bình luận

Xoá bình luận

Ẩn, thích, ghim