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.

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. Yêu cầu ở 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 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"

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 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

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.

Bắt đầu

Khái niệm

Tích hợp

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

Bình luận

Tin nhắn trực tiếp

AutoDM monitor

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

​Bình luận

​Tin nhắn trực tiếp

​AutoDM monitor

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

Bình luận

Tin nhắn trực tiếp

AutoDM monitor