Memulai

Dokumen ini menjelaskan cara agar berhasil memanggil dukungan Messenger API untuk Instagram (juga dikenal sebagai API Messaging Instagram di Kebijakan Developer kami) dengan aplikasi Anda dan mendapatkan pesan akun Profesional Instagram. Asumsinya: Anda familier dengan Graph API dan Facebook Login.

Sebelum Memulai

Anda akan memerlukan akses ke beberapa hal berikut:

• Akun Profesional Instagram
• Halaman Facebook yang terhubung ke akun itu
• Akun Developer Meta yang dapat melakukan tugas MODERATE di Halaman itu
• Aplikasi Meta dibuat dengan Kasus Penggunaan Facebook Login dan dengan pengaturan Dasar yang telah terkonfigurasi

Developer yang baru di Platform Messenger

• Ikuti panduan langkah demi langkah yang dijelaskan di bawah ini tentang cara membuat Token Akses Halaman, penyiapan Webhooks.
• Pelajari tentang berbagai fitur platform dan adopsi yang sesuai dengan kebutuhan Anda.

Developer dengan pengalaman sebelumnya di Platform Messenger

• Konsep token akses serupa dengan konsep Webhooks. Dukungan API Messenger untuk Instagram akan membutuhkan instagram_manage_messages di Token Akses Halaman dan berlangganan ke Webhooks topik Instagram.
• Sebagian besar fitur mirip Messenger API. Tinjau detail pada daftar fitur dan adopsi yang sesuai dengan kebutuhan Anda.

Alur Login

Anda dapat menggunakan Facebook Login atau Login Bisnis untuk Instagram untuk meminta izin yang diperlukan dari pengguna aplikasi Anda.

Alur Login Bisnis untuk Instagram memungkinkan seseorang untuk menyelesaikan hal berikut selama alur login:

• mengonversi akun Instagram miliknya menjadi akun Profesional Instagram
• membuat Halaman Facebook untuk bisnis miliknya
• menghubungkan Halaman itu ke akun Profesional Instagram miliknya

Untuk menerapkan Login Bisnis untuk Instagram, kunjungi Panduan Login Bisnis untuk Instagram , lalu kembalilah ke panduan ini.

1. Mendapatkan Token Akses Pengguna

Pastikan Anda masuk ke akun Developer Facebook, lalu akses aplikasi Anda dan picu modal Facebook Login. Ingatlah, akun Developer Facebook Anda harus dapat melakukan Tugas dengan setidaknya akses tingkat "Moderat" di Halaman Facebook yang terhubung ke akun Instagram yang ingin Anda kueri.

Setelah Anda memicu modal, klik OK untuk memberikan izin instagram_basic, instagram_manage_messages, dan pages_manage_metadata kepada aplikasi Anda.

API akan memberikan token akses Pengguna. Ambil gambar token sehingga aplikasi Anda dapat menggunakannya pada beberapa kueri berikutnya. Jika Anda menggunakan Graph API Explorer, gambarnya akan diambil secara otomatis dan ditampilkan di kolom Token Akses sebagai referensi:

2. Mendapatkan Halaman Pengguna

Kueri endpoint GET /me/accounts (ini diterjemahkan menjadi GET /{user-id}/accounts, yang melakukan GET pada node Pengguna Facebook, berdasarkan token akses Anda).

curl -i -X GET \
 "https://graph.facebook.com/v9.0/me/accounts?access_token={access-token}"

Ini akan mengembalikan koleksi Halaman Facebook tempat Pengguna Facebook saat ini dapat melakukan tugas MANAGE, CREATE_CONTENT, MODERATE, atau ADVERTISE:

{
  "data": [
    {
      "access_token": "EAAJjmJ...",
      "category": "App Page",
      "category_list": [
        {
          "id": "2301",
          "name": "App Page"
        }
      ],
      "name": "Metricsaurus",
      "id": "134895793791914",  // capture the Page ID
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    }
  ]
}

Ambil gambar ID Halaman Facebook yang terhubung ke akun Instagram yang ingin Anda kueri. Perlu diingat bahwa pengguna aplikasi mungkin melakukan tugas di beberapa halaman, jadi pada akhirnya Anda harus menerapkan logika yang dapat menentukan ID Halaman yang hendak diambil (atau merancang UI tempat pengguna aplikasi dapat mengidentifikasi Halaman yang tepat untuk Anda).

3. Mendapatkan Token Akses Halaman

Untuk melakukan berbagai panggilan API Messaging Instagram, Anda perlu menggunakan Token Akses Halaman (PAT) terkait dari akun Instagram yang sesuai dan sebelumnya telah diberikan melalui alur Facebook Login.

Kirim permintaan GET ke endpoint /{page-id} menggunakan token akses Pengguna Anda. Contoh:

curl -i -X GET "https://graph.facebook.com/{page-id}?
  fields=access_token&
  access_token={user-access-token}"  

Setelah berhasil, aplikasi Anda mendapatkan tanggapan ini:

{
  "access_token":"{page-access-token}",
  "id":"{page-id}"              
}  

• Jika Anda menggunakan token akses Pengguna berdurasi singkat, token akses Halaman hanya valid selama 1 jam.
• Jika Anda menggunakan token akses Pengguna berdurasi panjang, token akses Halaman tidak memiliki tanggal kedaluwarsa.

Untuk membuat token akses Halaman berdurasi panjang, Anda dapat mengikuti panduan di sini.

3a. Mendapatkan Token Akses Halaman melalui Fitur Dasbor Developer Instagram

Atau, jika Anda memiliki aset (akun Instagram dan halaman Facebook) yang ingin Anda onboarding ke dukungan API Messenger untuk Instagram, Anda dapat memanfaatkan fitur pengaturan Instagram di bawah Dasbor Aplikasi Developer untuk memungkinkan Anda menyiapkan Token Akses Halaman dan Webhooks dengan mudah. Anda dapat menemukan fitur di bagian dasbor aplikasi Developer → Messenger → Pengaturan Instagram. Cara yang ada untuk mengonfigurasi token dan webhook akan tetap berfungsi, tetapi fitur ini akan memberi Anda cara yang lebih mudah untuk mengatur lingkungan Anda.

4. Mengaktifkan Pengaturan Fitur Terhubung Kontrol Pesan

Untuk mengelola pesan Instagram melalui API, akun Profesional Instagram perlu mengaktifkan pengalih fitur yang terhubung di bagian pengaturan kontrol pesan.

5. Mendapatkan Objek Kotak Masuk Akun Profesional Instagram

Gunakan ID Halaman yang Anda ambil gambarnya dan Token Akses Halaman (PAT) untuk melakukan kueri endpoint GET /{page-id}/conversations?platform=instagram:

curl -i -X GET \
 "https://graph.facebook.com/v9.0/17841405822304914/conversations?platform=instagram&access_token={access-token}"  

Ini memberikan ID dari semua objek utas pada pengguna Instagram:

{
  "data": [
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTM2MDk5MDc1MzYyOTgx"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTYzMzQ2MzE5NjM1NDcy"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTk3MTY0NjI2NzAyMjMw"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MzkzNDI5MDYzMzkyNjU0"
    }
}

Jika Anda berhasil melakukan kueri terakhir ini, Anda seharusnya dapat melakukan kueri menggunakan salah satu dukungan Messenger API untuk endpoint Instagram - cukup rujuk berbagai panduan dan referensi kami untuk mempelajari apa yang dapat dilakukan setiap endpoint dan izin apa yang diperlukan.

Langkah Berikutnya

• Kembangkan aplikasi Anda lebih jauh agar dapat berhasil menggunakan endpoint lain yang diperlukan, dan lacak izin yang diperlukan setiap endpoint
• Selesaikan penyiapan Webhooks agar dapat menerima notifikasi real-time setiap kali pengguna mengirim pesan ke akun Profesional Instagram.
• Selesaikan proses Tinjauan Aplikasi dan minta persetujuan untuk semua izin yang diperlukan aplikasi Anda sehingga pengguna aplikasi dapat memberikannya saat aplikasi Anda dalam produksi.