> ## Documentation Index
> Fetch the complete documentation index at: https://docs.madiad.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tương tác

> Đọc bình luận, trả lời công khai hoặc qua DM, và chạy AutoDM monitor.

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

<Tip>
  Để 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`](/vi/concepts/posts) 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.
</Tip>

<Note>
  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`.
</Note>

<Note>
  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.
</Note>

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

```bash theme={null}
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`:

```bash theme={null}
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:

```bash theme={null}
# 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`:

```bash theme={null}
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á." }'
```

```bash theme={null}
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.

<Note>
  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.
</Note>

```bash theme={null}
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.                            |