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.
Token Instagram yang tidak diperbarui dalam 60 hari akan kedaluwarsa dan tidak lagi dapat diperbarui.
Subkode Graph API di bawah kode 190, untuk sesi yang berakhir karena perubahan kata sandi; orang tersebut harus masuk kembali.
Dari pengiriman webhook pesan yang gagal sebelum Meta menonaktifkannya dan membatalkan langganan aplikasi dari akun tersebut.
Meta dapat mengakhiri akses aplikasi ke izin atau fitur yang tidak digunakan dalam periode 28 hari.
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 returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A 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 off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A 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_indari 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_idsetiap 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.
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