MasukMulai uji coba gratis
easyCoexistence API resmi

Mengapa koneksi Instagram API berhenti berfungsi, dan cara menjaganya tetap aktif

Koneksi Instagram API berhenti berfungsi ketika Meta tidak lagi menerima tokennya atau akun tidak lagi memenuhi syarat: token berumur panjang yang tidak diperbarui selama 60 hari, perubahan kata sandi, izin atau seluruh aplikasi dihapus oleh pemilik, peralihan ke akun pribadi, atau pembatasan pada akun. Setiap penyebab mengembalikan kesalahannya sendiri, dan sebagian besar diperbaiki dengan cara pemilik masuk kembali.

easyCoexistence memantau setiap koneksi Instagram sepanjang waktu: memperbarui token jauh sebelum 60 hari habis, memeriksa akun setiap 6 jam, dan mengirim email sekali ketika Meta menolak akses serta mengirim channel.disconnected ke platform, sehingga koneksi yang terputus kembali dengan satu kali masuk.

60 days

Token Instagram yang tidak diperbarui dalam 60 hari akan kedaluwarsa dan tidak lagi dapat diperbarui.

460

Subkode Graph API di bawah kode 190, untuk sesi yang berakhir karena perubahan kata sandi; orang tersebut harus masuk kembali.

1 hour

Dari pengiriman webhook pesan yang gagal sebelum Meta menonaktifkannya dan membatalkan langganan aplikasi dari akun tersebut.

28 days

Meta dapat mengakhiri akses aplikasi ke izin atau fitur yang tidak digunakan dalam periode 28 hari.

6 hours

Seberapa sering easyCoexistence memeriksa setiap akun Instagram yang terhubung, dan memperbarui tokennya jauh sebelum 60 hari habis.

Mengapa koneksi Instagram API berhenti berfungsi?

Karena Meta berhenti menerima token, atau akun berhenti memenuhi syarat untuk API. Dokumentasi Meta menyebut penyebabnya satu per satu, beserta apa yang dikembalikan API dan langkah yang memulihkan akses. Sebagian besar muncul pertama kali sebagai panggilan yang gagal, itulah sebabnya pemeriksaan di bawah mencarinya secara terjadwal:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

Kapan token kedaluwarsa, dan kapan masih bisa diperbarui?

Dengan Instagram Login, token berumur panjang berlaku 60 hari sejak pembaruan terakhir. Pembaruan dengan grant_type=ig_refresh_token memberinya 60 hari lagi, asalkan token berumur minimal 24 jam, belum kedaluwarsa, dan pemilik telah memberikan instagram_business_basic. Setelah 60 hari berlalu, panggilan gagal dengan kode 190 dan hanya masuk baru yang membantu. Dengan Unified Login, konfigurasi menentukan apakah token kedaluwarsa sama sekali.

Apa yang dilakukan perubahan kata sandi dan izin yang dihapus?

Perubahan kata sandi dapat mengakhiri sesi yang dimiliki token: panduan kesalahan Graph API Meta mencatatnya sebagai kode 190 dengan subkode 460 dan menyatakan orang tersebut harus masuk ke aplikasi lagi. Izin yang tidak pernah diberikan atau sudah dihapus mengembalikan kode 10, atau kode dari 200 hingga 299; untuk DM, kode 200 dengan subkode 2534041 berarti pemilik mematikan akses ke pesan. Platform Terms Meta juga memungkinkannya mengakhiri akses aplikasi ke izin atau fitur yang tidak digunakan selama 28 hari.

Apa yang terjadi ketika pemilik menghapus aplikasi?

Aksesnya ke data non-publik berakhir. Pemilik menghapus aplikasi di Instagram pada Izin situs web, Aplikasi dan situs web, Aktif, dan Meta memanggil URL callback deauthorize yang tersimpan di pengaturan login bisnis aplikasi. Pusat Bantuan Instagram menyatakan aplikasi yang dihapus hanya dapat menjangkau informasi publik akun sejak saat itu, sehingga koneksi berakhir sampai pemilik masuk lagi.

Apa yang terjadi ketika akun berubah jenis atau dibatasi?

Keduanya membawa akun keluar dari apa yang dilayani API. API Meta hanya bekerja dengan akun profesional, dan tabel pemecahan masalah Unified Login-nya memberi pesan (#10) Access is denied because the instagram account type is not business or creator untuk akun yang beralih ke pribadi; pemilik beralih kembali, lalu menyambung ulang. Akun yang dibatasi, tidak aktif, atau sedang menjalani pemeriksaan mengembalikan kode 25 dengan subkode 2207050, yang diselesaikan pemilik di aplikasi Instagram.

Bagaimana webhook berhenti datang?

Melalui endpoint yang gagal. Meta mencoba ulang notifikasi Instagram hingga 36 jam, tetapi pengiriman pesan lebih ketat: setelah 15 menit kegagalan, peringatan dikirim ke akun developer, dan setelah satu jam Meta mengirim peringatan Webhooks Disabled serta membatalkan langganan aplikasi dari akun. Setelah endpoint berfungsi kembali, POST /<IG_ID>/subscribed_apps dengan field yang sama mengaktifkan kembali notifikasi.

Bagaimana Anda mengetahui penurunan sebelum pengguna menyadarinya?

Dengan memeriksa koneksi secara terjadwal, alih-alih menunggu sebuah postingan gagal:

  • Simpan expires_in dari setiap pertukaran dan pembaruan token, lakukan pembaruan jauh sebelum hari ke-60, setelah token berumur satu hari.
  • Lakukan panggilan terautentikasi yang ringan secara terjadwal, seperti GET /me?fields=user_id,username, dan perlakukan kode 190 atau 102 sebagai tanda perlu sambung ulang.
  • Sediakan callback deauthorize, agar penghapusan di pengaturan Instagram langsung sampai ke Anda.
  • Baca Developer Alerts dan email bisnis pada aplikasi, tempat Meta mengirim pemberitahuan webhook dan tinjauan.
  • Catat kode, subkode, dan fbtrace_id setiap kesalahan per akun, agar pembatasan terpisah dari permintaan yang buruk.

Bagaimana menyambung ulang setiap kasus?

Sebagian besar penyebab berakhir pada langkah yang sama, yaitu masuk baru oleh pemilik akun, yang menerbitkan kode dan token baru. Pengecualiannya adalah pengaturan yang diubah pemilik di aplikasi Instagram:

  • Token kedaluwarsa, perubahan kata sandi, aplikasi atau izin dihapus: minta pemilik masuk lagi dan menyetujui izin.
  • Akun pribadi: beralih kembali ke Bisnis atau Kreator di aplikasi Instagram, lalu masuk lagi.
  • Pesan dimatikan: aktifkan Izinkan akses ke pesan di bawah Alat terhubung; tidak perlu masuk baru.
  • Akun dibatasi: selesaikan yang diminta aplikasi Instagram; masuk baru tidak mengubah apa pun.
  • Webhook dinonaktifkan: perbaiki endpoint, lalu berlangganan kembali akun.

Apa yang dilakukan easyCoexistence untuk menjaga koneksi tetap aktif?

Ia memantau setiap akun Instagram yang terhubung sepanjang waktu. Ia memperbarui token ketika sisa masa berlakunya kurang dari 20 dari 60 hari, memeriksa akun setiap 6 jam dengan GET /me, dan menandai koneksi untuk disambung ulang begitu Meta menolak token, baik dalam pemeriksaan itu maupun dalam panggilan alat. Ia menjawab pengiriman webhook Meta seketika dan meneruskannya kemudian, dan ketika pemilik menghapus aplikasi di pengaturan Instagram, callback deauthorize Meta mengakhiri koneksi dan mengeluarkannya dari tagihan.

Bagaimana easyCoexistence memberi tahu Anda, dan bagaimana menyambung ulang?

Sekali, lewat email, dengan menyebut akun dan tombol ke halaman saluran; platform juga menerima event channel.disconnected yang ditandatangani. Sampai pemilik bertindak, list_social_accounts menampilkan status dan kesalahan terakhir dari Meta, dan alat menjawab bahwa akun perlu disambung ulang. Menyambung ulang cukup dengan satu kali masuk memakai akun Instagram yang sama, yang menghidupkan kembali koneksi yang sama beserta pengaturannya.

Kesalahan umum

  • Memperbarui token hanya setelah panggilan gagal. Setelah kedaluwarsa, Meta menolak pembaruan, jadi jadwalkan pembaruan selagi token masih berlaku.
  • Mengirim akun yang dibatasi kembali ke proses masuk. Kode 25 dengan subkode 2207050 adalah keadaan akun, yang diperbaiki pemilik di aplikasi Instagram.
  • Membiarkan callback deauthorize tidak diatur. Penghapusan di pengaturan Instagram kemudian baru terlihat ketika panggilan berikutnya gagal.
  • Memperbaiki endpoint yang gagal lalu menunggu. Setelah peringatan Webhooks Disabled, notifikasi tetap mati sampai akun berlangganan lagi dengan POST /<IG_ID>/subscribed_apps.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah menggunakan token Instagram mencegahnya kedaluwarsa?

Tidak. Hanya pembaruan yang memperpanjang token berumur panjang, dan token yang melewati 60 hari tanpa pembaruan akan kedaluwarsa berapa kali pun digunakan.

Apakah Instagram menghapus aplikasi bisnis setelah 90 hari tidak digunakan?

Tidak. Pusat Bantuan Instagram menyatakan aplikasi dengan izin untuk mengelola akun bisnis dan kreator tidak kedaluwarsa setelah 90 hari tidak aktif.

Apakah akun yang terputus tetap dihitung di tagihan easyCoexistence?

Ya, sampai Anda menyambung ulang atau menghapusnya. Akun yang pemiliknya menghapus aplikasi di pengaturan Instagram keluar dari hitungan segera setelah Meta melaporkan penghapusan.

Berapa biaya easyCoexistence untuk memantau akun Instagram?

Pemantauan termasuk di setiap koneksi: US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada