Instagram API 接続が止まる理由と、接続を維持する方法
Instagram API 接続は、Meta がトークンを受け付けなくなる、またはアカウントが条件を満たさなくなると止まります。60 日間更新されなかった長期トークン、パスワード変更、オーナーによる権限やアプリの削除、個人アカウントへの切り替え、アカウントへの制限が原因です。それぞれ異なるエラーが返され、多くはオーナーがサインインし直すことで解決します。
easyCoexistence は Instagram 接続を 24 時間体制で監視します。
60 日以内に更新されなかった Instagram トークンは期限切れとなり、もう更新できなくなります。
パスワード変更によってセッションが終了した場合、Graph API はコード 190 の下にサブコードを返します。本人が再度ログインする必要があります。
失敗したメッセージング Webhook 配信のうち、Meta が無効化してアプリをアカウントから購読解除するまでの件数。
Meta は、28 日間使われなかったアプリの権限や機能へのアクセスを終了することがあります。
easyCoexistence が接続済みの各 Instagram アカウントを確認する頻度と、60 日が終わるかなり前にトークンを更新する仕組み。
Instagram API 接続が止まるのはなぜですか?
Meta がトークンを受け付けなくなるか、アカウントが API の対象条件を満たさなくなるためです。Meta のドキュメントは原因を挙げており、それぞれ API が返すもの、アクセスを回復する手順も示しています。多くは最初に呼び出しの失敗として現れるため、以下のチェックで定期的に確認します:
| 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 |
トークンはいつ期限切れになり、いつまで更新できますか?
Instagram Login では、長期トークンは最後の更新から 60 日間有効です。grant_type=ig_refresh_token を使って更新すると、さらに 60 日間延長されます。ただし、トークンが 24 時間以上経過していて、期限切れでなく、オーナーが instagram_business_basic を許可している必要があります。60 日が過ぎると、呼び出しはコード 190 で失敗し、再サインインしか解決策がありません。Unified Login では、設定によってトークンが期限切れになるかどうかが決まります。
パスワード変更と権限の削除は何を引き起こしますか?
パスワード変更により、トークンが属するセッションが終了することがあります。Meta の Graph API エラーガイドでは、これはコード 190、サブコード 460 として報告され、本人がアプリに再度ログインする必要があるとされています。一度も許可されなかった、または削除された権限は、コード 10、または 200 から 299 のいずれかのコードを返します。DM の場合、コード 200 とサブコード 2534041 は、オーナーがメッセージへのアクセスをオフにしたことを意味します。Meta のプラットフォーム規約では、28 日間使われなかった権限や機能へのアプリのアクセスを終了させることもあります。
オーナーがアプリを削除すると何が起きますか?
アプリは非公開データへのアクセスを失います。オーナーは Instagram で「Website permissions」、「Apps and websites」、「Active」の順に進んでアプリを削除します。すると Meta は、アプリのビジネスログイン設定に保存された deauthorize コールバック URL を呼び出します。Instagram のヘルプセンターによると、削除されたアプリは以後アカウントの公開情報にしかアクセスできません。そのため、オーナーが再度サインインするまで接続は終了したままです。
アカウントの種類が変わったり制限されたりするとどうなりますか?
どちらの場合も、アカウントは API の対象外になります。Meta の API はプロフェッショナルアカウントのみに対応しており、Unified Login のトラブルシューティング表には、個人アカウントに切り替えられたアカウントに対して「Access is denied because the instagram account type is not business or creator」というメッセージ(#10)が示されています。オーナーはアカウントの種類を戻してから、再度接続します。制限されている、非アクティブ、またはチェックポイントに入ったアカウントはコード 25 とサブコード 2207050 を返し、オーナーが Instagram アプリで解決します。
Webhook はどのように届かなくなりますか?
エンドポイントが失敗することによって届かなくなります。Meta は Instagram の通知を最大 36 時間再試行します。ただしメッセージングの配信はより厳格で、15 分間失敗が続くと開発者アカウントにアラートが届き、1 時間後には Meta が「Webhooks Disabled」アラートを送信し、アカウントからアプリの購読を解除します。エンドポイントが再び動作したら、同じフィールドを指定して POST /<IG_ID>/subscribed_apps を実行すると、通知が再びオンになります。
ユーザーより先に接続の低下に気づくにはどうすればよいですか?
投稿の失敗を待つのではなく、定期的に接続を確認します:
- 各トークンの交換で得た
expires_inを保存し、トークンが 1 日経過したら 60 日目よりかなり前に更新します。 - GET /me?fields=
user_id,username のような軽量な認証済み呼び出しを定期的に行い、コード 190 または 102 を再接続が必要な状態として扱います。 - deauthorize コールバックを用意しておけば、Instagram の設定での削除がすぐに届きます。
- アプリの Developer Alerts とビジネスメールを確認します。Meta は Webhook やレビューに関する通知をここに送ります。
- エラーのコード、サブコード、
fbtrace_idをアカウントごとに記録し、制限と不正なリクエストを区別できるようにします。
原因ごとに再接続するにはどうすればよいですか?
ほとんどの原因は、アカウントのオーナーが再度サインインするという同じ手順で解決します。これにより新しいコードとトークンが発行されます。例外は、Instagram アプリでオーナーが変更する設定です:
- トークンの期限切れ、パスワード変更、アプリまたは権限の削除:オーナーに再度ログインしてもらい、権限を許可してもらいます。
- 個人アカウント:Instagram アプリでビジネスまたはクリエイターに戻してから、再度サインインします。
- メッセージがオフ:「Connected tools」で「Allow access to messages」をオンにします。新しいサインインは不要です。
- 制限されたアカウント:Instagram アプリが求める手続きを完了します。新しいサインインでは何も変わりません。
- 無効化された Webhook:エンドポイントを修正してから、アカウントの購読を再度行います。
easyCoexistence は接続を維持するために何をしますか?
接続された各 Instagram アカウントを 24 時間体制で監視します。残りの有効期間が 60 日のうち 20 日を下回ると、トークンを更新します。6 時間ごとに GET /me でアカウントを確認し、Meta がトークンを拒否した時点で、そのチェックでも、ツール呼び出しでも、接続を再接続が必要な状態としてマークします。Meta の Webhook 配信にはすぐに応答し、後から転送します。オーナーが Instagram の設定でアプリを削除すると、Meta の deauthorize コールバックにより接続が終了し、請求からも外れます。
easyCoexistence はどのように通知し、どのように再接続しますか?
メールで 1 回お知らせします。アカウント名を記載し、チャネルのページへのボタンも含まれます。プラットフォームには、署名付きの channel.disconnected イベントも届きます。オーナーが対応するまで、list_social_accounts はステータスと Meta の最後のエラーを表示し、ツールはアカウントの再接続が必要だと返します。再接続は、同じ Instagram アカウントで 1 回サインインするだけです。これにより、同じ接続が設定とともに復元されます。
よくある間違い
- 呼び出しが失敗した後にだけトークンを更新すること。期限が切れると Meta は更新を拒否するため、トークンが有効なうちに更新をスケジュールしてください。
- 制限されたアカウントを再度ログインさせること。コード 25 とサブコード 2207050 はアカウントの状態であり、オーナーが Instagram アプリで解決します。
- deauthorize コールバックを設定しないままにすること。Instagram の設定で削除されても、次の呼び出しが失敗するまで分かりません。
- 失敗したエンドポイントを直したあと、そのまま待つこと。Webhooks Disabled アラートの後は、POST /<IG_ID>/subscribed_apps で購読し直すまで通知はオフのままです。
60 日が終わるかなり前にトークンを更新し、6 時間ごとにアカウントを確認し、Meta がアクセスを拒否した際はメールで 1 回お知らせします。プラットフォームには channel.disconnected を送信するため、切断された接続も 1 回のサインインで復旧できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram トークンを使えば期限切れを防げますか?
いいえ。長期トークンを延長できるのは更新だけです。60 日間更新されなかったトークンは、どれだけ使われていたとしても期限切れになります。
Instagram は 90 日間使われなかったビジネスアプリを削除しますか?
いいえ。Instagram のヘルプセンターによると、ビジネスアカウントとクリエイターアカウントを管理する権限を持つアプリは、90 日間使われなくても期限切れになりません。
切断されたアカウントは easyCoexistence の請求に含まれますか?
はい。再接続するか削除するまで含まれます。オーナーが Instagram の設定でアプリを削除したアカウントは、Meta が削除を報告した時点で件数から外れます。
easyCoexistence で Instagram アカウントを監視するには、いくらかかりますか?
監視は各接続に含まれます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日