Lượt nhắc

Xác định những chú thích, bình luận và File phương tiện trên Instagram mà bí danh của Người sáng tạo nội dung hoặc Doanh nghiệp trên Instagram được gắn thẻ hoặc @nhắc đến.

Các giới hạn

Không hỗ trợ Lượt nhắc trên Tin.
Không hỗ trợ bình luận trên các ảnh mà bạn được gắn thẻ.
Webhooks sẽ không được gửi nếu file phương tiện có bình luận hoặc lượt @nhắc đến do một tài khoản ở chế độ riêng tư tạo.

Điểm cuối

API này bao gồm các điểm cuối sau:

GET /{ig-user-id}/tags – để lấy các đối tượng file phương tiện mà Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh được gắn thẻ
GET /{ig-user-id}?fields=mentioned_comment – để lấy dữ liệu về bình luận mà Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh được @nhắc đến
GET /{ig-user-id}?fields=mentioned_media – để lấy dữ liệu về đối tượng file phương tiện mà Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh được @nhắc đến trong chú thích
POST /{ig-user-id}/mentions – để trả lời bình luận hoặc chú thích của đối tượng file phương tiện mà Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh được người dùng Instagram khác @nhắc đến

Hãy xem tài liệu tham khảo của từng điểm cuối để biết các hướng dẫn về cách sử dụng.

Webhooks

Hãy đăng ký trường mentions để nhận thông báo của Webhooks Instagram mỗi khi người dùng Instagram nhắc đến một Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh trên Instagram. Lưu ý rằng chúng tôi không lưu trữ dữ liệu thông báo của Webhooks. Vì vậy, nếu thiết lập Webhook để theo dõi lượt nhắc, bạn nên lưu trữ mọi dữ liệu nhận được nếu định sử dụng sau này.

Ví dụ

Theo dõi và trả lời @lượt nhắc trong bình luận

Bạn có thể theo dõi @lượt nhắc trong bình luận và trả lời bất kỳ lượt nhắc nào đáp ứng tiêu chí:

Thiết lập webhook Instagram đã đăng ký trường mentions.
Thiết lập tập lệnh có thể phân tích cú pháp thông báo của Webhooks và xác định ID bình luận.
Sử dụng ID để truy vấn điểm cuối GET /{ig-user-id}/mentioned_comment nhằm có thêm thông tin về từng bình luận.
Phân tích các kết quả trả về để xác định bất kỳ bình luận nào đáp ứng tiêu chí.
Sử dụng điểm cuối POST /{ig-user-id}/mentions để phản hồi những bình luận đó.

Phần phản hồi sẽ xuất hiện dưới dạng bình luận chuỗi con trong bình luận mà Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh được nhắc đến.

Theo dõi và trả lời @lượt nhắc trong chú thích

Bạn có thể theo dõi @lượt nhắc trong chú thích và trả lời bất kỳ lượt nhắc nào đáp ứng tiêu chí:

Thiết lập webhook Instagram đã đăng ký trường mentions.
Thiết lập tập lệnh có thể phân tích cú pháp thông báo của Webhooks và xác định ID file phương tiện.
Sử dụng ID để truy vấn điểm cuối GET /{ig-user-id}/mentioned_media nhằm có thêm thông tin về từng đối tượng file phương tiện.
Phân tích các kết quả trả về để xác định đối tượng file phương tiện có chú thích đáp ứng tiêu chí.
Sử dụng điểm cuối POST /{ig-user-id}/mentions để bình luận trên các đối tượng file phương tiện đó.