מדוע חיבור ה-API של Instagram מפסיק לעבוד, וכיצד לשמור עליו פעיל
חיבור ה-API של Instagram מפסיק לעבוד כש-Meta כבר לא מקבלת את האסימון שלו, או כשהחשבון כבר לא עומד בתנאים. הסיבות: אסימון לטווח ארוך שלא רוענן במשך 60 ימים, שינוי סיסמה, הסרת הרשאה או של האפליקציה כולה על ידי הבעלים, מעבר לחשבון אישי, או הגבלה על החשבון. כל מקרה מחזיר שגיאה משלו, וברוב המקרים מספיק שהבעלים יתחבר מחדש.
easyCoexistence עוקב אחרי כל חיבור Instagram לאורך כל שעות היממה: הוא מרענן את האסימון הרבה לפני תום 60 הימים, בודק את החשבון כל 6 שעות, שולח לכם מייל אחד כש-Meta מסרבת לגישה ושולח לפלטפורמות channel.disconnected, כך שחיבור שנפל חוזר עם כניסה אחת.
אסימונים של Instagram שלא רוענו תוך 60 ימים פגים, ואי אפשר עוד לרענן אותם.
תת-קוד (subcode) של Graph API תחת קוד 190 מציין הפעלה שהסתיימה בשל שינוי סיסמה; האדם מתחבר שוב.
מתוך כשלונות מסירה של וובהוקים (Webhook) להודעות, לפני שחברת Meta משביתה אותם ומנתקת את האפליקציה מהחשבון.
Meta עשויה לסיים את הגישה של אפליקציה להרשאות או לתכונות שלא נעשה בהן שימוש בתוך תקופה של 28 ימים.
תדירות הבדיקה של easyCoexistence לכל חשבון Instagram מחובר, וחידוש האסימון הרבה לפני תום 60 הימים.
מדוע חיבור ה-API של Instagram מפסיק לעבוד?
כי 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, ההגדרה קובעת אם האסימון פג תוקף בכלל.
מה עושים שינוי סיסמה והסרת הרשאה?
שינוי סיסמה עשוי לסיים את ההפעלה שאליה שייך האסימון: מדריך השגיאות של Graph API של Meta מדווח על כך כקוד 190 עם תת-קוד 460, ואומר שהאדם חייב להתחבר שוב לאפליקציה. הרשאה שמעולם לא ניתנה או שהוסרה מחזירה קוד 10, או קוד בין 200 ל-299; בהודעות ישירות (DM), קוד 200 עם תת-קוד 2534041 פירושו שהבעלים כיבה את הגישה להודעות. תנאי הפלטפורמה של Meta מאפשרים לה גם לסיים את הגישה של אפליקציה להרשאה או לתכונה שלא נעשה בהן שימוש במשך 28 ימים.
מה קורה כשהבעלים מסיר את האפליקציה?
הגישה שלה למידע שאינו ציבורי מסתיימת. הבעלים מסיר את האפליקציה ב-Instagram תחת Website permissions, Apps and websites, Active, ו-Meta קוראת לכתובת ה-URL של ה-deauthorize callback השמורה בהגדרות ההתחברות העסקית של האפליקציה. מרכז העזרה של Instagram מציין שאפליקציה שהוסרה יכולה מאז ואילך להגיע רק למידע הציבורי של החשבון, ולכן החיבור מסתיים עד שהבעלים מתחבר שוב.
מה קורה כשהחשבון משנה סוג או מוגבל?
כל אחד מהם מוציא את החשבון אל מחוץ לתחום שבו ה-API משרת. ה-API של Meta עובד רק עם חשבונות מקצועיים, ובטבלת פתרון הבעיות של Unified Login מופיעה ההודעה (#10) Access is denied because the instagram account type is not business or creator עבור חשבון שהועבר לאישי. הבעלים מחזיר את החשבון למצב עסקי או יוצר, ואז מתחבר שוב. חשבון מוגבל, לא פעיל או עם checkpoint מחזיר קוד 25 עם תת-קוד 2207050, והבעלים פותר זאת באפליקציית Instagram.
איך וובהוקים מפסיקים להגיע?
דרך נקודת קצה שנכשלת. Meta מנסה שוב לשלוח התראה של Instagram עד 36 שעות, אבל מסירות של הודעות מחמירות יותר: אחרי 15 דקות של כשלונות נשלחת התראה לחשבון המפתח, ואחרי שעה Meta שולחת התראת Webhooks Disabled ומנתקת את האפליקציה מהחשבון. לאחר שנקודת הקצה חוזרת לעבוד, POST /<IG_ID>/subscribed_apps עם אותם שדות מפעיל מחדש את ההתראות.
איך מבחינים בירידה לפני שהמשתמשים מבחינים בה?
על ידי בדיקת החיבור לפי לוח זמנים, במקום לחכות שפוסט ייכשל:
- שומרים את
expires_inמכל החלפת אסימון ומכל רענון, ומרעננים הרבה לפני היום ה-60, מרגע שהאסימון בן יום. - מבצעים קריאה מאומתת זולה לפי לוח זמנים, כמו GET /me?fields=
user_id,username, ומתייחסים לקוד 190 או 102 כחיבור מחדש נדרש. - מפעילים את ה-deauthorize callback, כך שהסרה בהגדרות של Instagram מגיעה מיד.
- קוראים את Developer Alerts ואת הדואר האלקטרוני העסקי של האפליקציה, שם Meta שולחת הודעות על וובהוקים ועל סקירת האפליקציה.
- רושמים ביומן את הקוד, את תת-הקוד ואת
fbtrace_idשל כל שגיאה לפי חשבון, כך שהגבלה נבדלת מבקשה שגויה.
איך מחברים מחדש כל מקרה?
רוב הסיבות מסתיימות באותו שלב, התחברות חדשה של בעל החשבון, שמנפיקה קוד חדש ואסימון חדש. היוצאים מן הכלל הם הגדרות שהבעלים משנה באפליקציית Instagram:
- אסימון שפג תוקפו, שינוי סיסמה, הסרת אפליקציה או הרשאה: שולחים את הבעלים שוב דרך ההתחברות ומאפשרים להם לאשר את ההרשאות.
- חשבון אישי: מחזירים לעסקי או ליוצר באפליקציית Instagram, ואז מתחברים שוב.
- הודעות שכובו: מפעילים את האפשרות Allow access to messages תחת Connected tools; אין צורך בהתחברות חדשה.
- חשבון מוגבל: משלימים את מה שאפליקציית Instagram מבקשת; התחברות חדשה לא משנה דבר.
- וובהוקים שהושבתו: מתקנים את נקודת הקצה, ואז מפעילים שוב את ההרשמה לחשבון.
מה easyCoexistence עושה כדי לשמור על חיבור פעיל?
הוא עוקב אחרי כל חשבון Instagram מחובר לאורך כל שעות היממה. הוא מרענן את האסימון כשנותרו פחות מ-20 מתוך 60 הימים, בודק את החשבון כל 6 שעות עם GET /me, ומסמן את החיבור כדורש חיבור מחדש ברגע ש-Meta מסרבת לאסימון, בין בבדיקה ובין בקריאה לכלי. הוא עונה מיד למסירות הוובהוקים של Meta ומעביר אותן לאחר מכן, וכשהבעלים מסיר את האפליקציה בהגדרות Instagram, ה-deauthorize callback של Meta מסיים את החיבור ומוציא אותו מהחיוב.
איך easyCoexistence מודיע לכם, ואיך מתחברים מחדש?
פעם אחת, במייל, עם שם החשבון וכפתור לעמוד הערוץ; פלטפורמות מקבלות גם אירוע channel.disconnected חתום. עד שהבעלים מטפל בכך, list_social_accounts מציג את הסטטוס ואת השגיאה האחרונה של Meta, והכלים משיבים שהחשבון צריך להתחבר מחדש. התחברות מחדש היא כניסה אחת עם אותו חשבון Instagram, שמחייה את אותו חיבור עם ההגדרות שלו.
טעויות נפוצות
- רענון אסימון רק לאחר שקריאה נכשלה. אחרי שפג תוקפו, Meta דוחה את הרענון, לכן יש לתזמן את החידושים בזמן שהאסימון עדיין בתוקף.
- שליחת חשבון מוגבל בחזרה דרך ההתחברות. קוד 25 עם תת-קוד 2207050 הוא מצבו של החשבון, שהבעלים מתקן באפליקציית Instagram.
- השארת ה-deauthorize callback בלי הגדרה. הסרה בהגדרות של Instagram אז מתגלה רק כשהקריאה הבאה נכשלת.
- תיקון נקודת הקצה שנכשלה והמתנה שההתראות יחזרו מעצמן. אחרי התראת Webhooks Disabled ההתראות נשארות כבויות, עד שהחשבון נרשם מחדש דרך POST /<IG_ID>/subscribed_apps והן חוזרות לפעולה.
מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, במחיר שיורד ככל שמוסיפים חיבורים, כולל תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם שימוש באסימון Instagram מונע ממנו לפוג?
לא. רק רענון מאריך אסימון לטווח ארוך, ואסימון שעבר 60 ימים בלי רענון פג, בלי קשר לתדירות השימוש בו.
האם Instagram מסירה אפליקציה עסקית אחרי 90 ימים ללא שימוש?
לא. מרכז העזרה של Instagram מציין שאפליקציות עם הרשאות לניהול חשבונות עסקיים ויוצרים אינן פוקעות לאחר 90 ימים של חוסר פעילות.
האם חשבון שנותק עדיין נספר בחיוב של easyCoexistence?
כן, עד שתתחברו מחדש או תסירו אותו. חשבון שהבעלים הסיר את האפליקציה שלו בהגדרות Instagram יוצא מהספירה מרגע ש-Meta מדווחת על ההסרה.
כמה עולה easyCoexistence לניטור חשבון Instagram?
הניטור כלול בכל חיבור: מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, במחיר שיורד ככל שמוסיפים חיבורים, כולל תקופת ניסיון של 3 ימים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-