Penyebutan

Identifikasi keterangan, komentar, dan Media Instagram yang telah memberi tanda atau @menyebut akun Instagram Business atau Akun Kreator Instagram.

Batasan

• Sebutan di Cerita tidak didukung.
• Berkomentar di foto yang Anda ditandai tidak didukung.
• Webhooks tidak akan dikirim jika Media tempat munculnya komentar atau @penyebutan dibuat oleh akun yang dikunci ke pribadi.

Endpoint

API terdiri dari endpoint berikut:

• GET /{ig-user-id}/tags — untuk mendapatkan objek media yang menandai Akun Instagram Business atau Akun Kreator
• GET /{ig-user-id}?fields=mentioned_comment — untuk mendapatkan data tentang komentar yang telah @menyebut Akun Instagram Business atau Akun Kreator Instagram
• GET /{ig-user-id}?fields=mentioned_media — untuk mendapatkan data tentang objek media yang telah @menyebut Akun Instagram Business atau Akun Kreator Instagram di keterangan
• POST /{ig-user-id}/mentions — untuk membalas komentar atau keterangan objek media bahwa Akun Instagram Business atau Akun Kreator Instagram telah @disebut oleh pengguna Instagram lainnya

Baca setiap dokumen referensi endpoint untuk petunjuk penggunaan.

Webhooks

Berlanggananlah ke kolom mentions untuk menerima notifikasi Webhooks Instagram setiap kali pengguna Instagram menyebutkan Akun Instagram Business atau Akun Kreator Instagram. Perhatikan bahwa kami tidak menyimpan data notifikasi Webhook, jadi jika Anda menyiapkan Webhook yang mendengarkan sebutan, Anda harus menyimpan data yang diterima jika Anda berencana untuk menggunakannya nanti.

Contoh

Mendengarkan dan Membalas Komentar @Sebutan

Anda dapat mendengarkan komentar @sebutan dan membalas komentar yang memenuhi kriteria Anda:

1. Siapkan webhook Instagram yang berlangganan ke kolom mentions.
2. Siapkan skrip yang dapat melakukan parse notifikasi Webhooks dan mengidentifikasi ID komentar.
3. Gunakan ID untuk meng-kueri endpoint GET /{ig-user-id}/mentioned_comment demi mendapatkan informasi selengkapnya tentang setiap komentar.
4. Analisis hasil yang dikembalikan untuk mengidentifikasi komentar apa pun yang memenuhi kriteria Anda.
5. Gunakan endpoint POST /{ig-user-id}/mentions untuk membalas komentar-komentar itu.

Balasan akan muncul sebagai komentar sub-utas di komentar yang menyebutkan Akun Instagram Business atau Akun Kreator Instagram.

Mendengarkan dan Membalas Keterangan @Sebutan

Anda dapat mendengarkan teks @sebutan dan membalas apa pun yang memenuhi kriteria Anda:

1. Siapkan Webhooks Instagram yang berlangganan ke kolom mentions.
2. Siapkan skrip yang dapat melakukan parse notifikasi Webhooks dan mengidentifikasi ID media.
3. Gunakan ID untuk meng-kueri endpoint GET /{ig-user-id}/mentioned_media demi mendapatkan informasi selengkapnya tentang setiap objek media.
4. Analisis hasil yang dikembalikan untuk mengidentifikasi objek media dengan teks yang memenuhi kriteria Anda.
5. Gunakan endpoint POST /{ig-user-id}/mentions untuk mengomentari objek media itu.