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 hoá tương tác (gửi DM, trả lời bình luận, AutoDM monitor) có từ gói Business trở lên. Request ở gói khác trả về 403. Mỗi gói cũng có hạn mức DM theo ngày, vượt sẽ trả về 429.
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 response.
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"
Bình luận
Đọ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
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 👀" }'
profile_id, comment_id, và message.
Tin nhắn trực tiếp
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 keyword kích hoạt.
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"]
}'
monitor_id. Quản lý monitor bằng id đó:
| Hành động | Request |
|---|
| 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 keyword này. |
monitoring_interval | không | Số phút giữa các lần kiểm tra. |
