איך לאפשר ללקוחות לחבר Instagram לאפליקציה שלכם
השרת שלכם קורא לנקודת הקצה POST /connect-sessions של easyCoexistence עם channel instagram, ושולח את הלקוח לכתובת ה-URL שמוחזרת, שם הוא נכנס עם Instagram Login בחשבון Business או Creator. הוא חוזר לכתובת redirect_url שלכם עם channel_id, ו-GET /channels/{id}?credentials=1 מחזיר אסימון עבור graph.instagram.com, כך שהאפליקציה שלכם יכולה לפרסם, לקרוא תגובות ולהשיב להודעות ישירות.
מספר הפוסטים שחשבון Instagram יכול לפרסם דרך ה-API בחלון נע של 24 שעות; קרוסלה נספרת כאחד.
Meta מאפשרת לפרסם ב-Instagram דרך ה-API רק תמונות מסוג JPEG בלבד.
חלון המענה הסטנדרטי להודעה ישירה של אדם ב-Instagram, ברוב פעולות המשתמש; האדם חייב לכתוב ראשון.
הודעות שחשבון יכול לשלוח למגיב בתגובה פרטית, בתוך 7 ימים מהתגובה.
משך הזמן שקישור החיבור של easyCoexistence פעיל לפני שהסשן שלו פג.
מה הלקוח עושה כדי להתחבר?
הלקוח לוחץ על כפתור אחד. האפליקציה שלכם יוצרת את הסשן כשהערך של channel הוא instagram, עם redirect_url, ומזהה הלקוח שלכם כ-external_ref, ואז שולחת את הלקוח לכתובת שהוחזרה. הדף המאוחסן מציג את שם העסק שלכם ואת הכפתור Continue with Instagram, שפותח את הכניסה של Instagram עצמה באותה לשונית, כך שזה עובד גם בטלפונים. הלקוח מאשר את הגישה וחוזר לכתובת redirect_url עם status=connected ועם channel_id, ואתם מאמתים זאת עם GET /connect-sessions/{id}.
אילו חשבונות Instagram יכולים להתחבר?
חשבונות מקצועיים מסוג Business או Creator, שאליהם מיועד ה-Instagram API של Meta. חשבון שכבר מחובר דרך שירות אחר שעובד עם easyCoexistence נדחה, והשדה last_error של הסשן מציין זאת; הלקוח מסיר אותו קודם שם, או נכנס עם חשבון אחר. להודעות ישירות צריך גם להפעיל ב-Instagram את האפשרות Allow access to messages באפליקציית Instagram, ומדריך החיבור ל-Instagram מראה את הנתיב.
איזה אסימון מקבלת האפליקציה שלכם?
אסימון משתמש של Instagram עבור graph.instagram.com/v25.0, עם account_id_on_meta, מזהה ה-Instagram של החשבון, מתוך GET /channels/{id}?credentials=1. easyCoexistence מרענן אותו הרבה לפני שתקופת 60 הימים מסתיימת, והרענון מנפיק אסימון חדש, לכן שולפים את פרטי הגישה בתחילת כל משימה ולא שומרים עותק אחד.
איך האפליקציה מפרסמת לחשבון?
דרך נקודת הקצה POST /channels/{id}/posts. השדה ig_type בוחר בין IMAGE, CAROUSEL, REELS ו-STORIES, ואם משמיטים אותו הוא מחושב מתוך המדיה: כמה קבצים הופכים לקרוסלה, וסרטון אחד הופך ל-Reel. קרוסלה כאן מכילה בין 2 ל-10 פריטים, תמונות חייבות להיות JPEG, הטקסט עד 2,200 תווים, ולפוסט ב-Instagram אין שדה קישור. בלי publish_at הפוסט יוצא עכשיו; עם השדה, בזמן שנקבע, עד 90 ימים קדימה.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ig_post_2291" \
-d '{
"text": "Three looks for the weekend.",
"ig_type": "CAROUSEL",
"media": [
{ "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
]
}'איך תגובות והודעות מגיעות לאפליקציה שלכם?
אחרי שמגדירים יעד. PUT /channels/{id}/webhook עם כתובת ה-URL שלכם מחזיר את סוד החתימה של אותו חשבון, ומאותו רגע התגובות, האזכורים וההודעות הישירות מועברים כשהם מגיעים, חתומים עם X-EC-Signature. הגוף מכיל את platform, account_id, external_id ואת ה-entry של Meta ללא שינוי, עם changes לתגובות ולאזכורים, ו-messaging להודעות ישירות.
איך האפליקציה משיבה לתגובות ולהודעות?
דרך ה-API של Meta בכתובת graph.instagram.com, עם האסימון של הלקוח, כך שכל תשובה יוצאת מחשבון הלקוח:
- להשיב לתגובה: POST /<
IG_COMMENT_ID>/replies עם הודעה. - להשיב להודעה ישירה: POST /<
IG_ID>/messages, עם recipient שמוגדר למזהה של האדם וטקסט ההודעה, בתוך 24 שעות מההודעה האחרונה שלו. - תגובה פרטית לתגובה: אותו edge של messages עם recipient שמכיל
comment_id, פעם אחת לכל תגובה, בתוך 7 ימים ממנה. - POST או DELETE אל /<
IG_COMMENT_ID> מסתירים או מוחקים את התגובה.
מה קורה כשהגישה של הלקוח מסתיימת?
כתובת ה-URL של האירועים שלכם מקבלת את האירוע channel.disconnected כש-Instagram דוחה את האסימון או כשהבעלים מבטל את הגישה בהגדרות של Instagram. סשן חיבור חדש ללקוח הזה מחזיר את החשבון. כדי לסיים מצדכם, קריאת DELETE /channels/{id} מבטלת את הגישה ברשת ומבטלת את הפוסטים שעדיין ממתינים בתור, והחיוב נפסק בסוף המחזור.
טעויות נפוצות
- שליחת תמונות PNG או WebP ל-Instagram. Meta מפרסמת רק JPEG, לכן הפוסט נדחה לפני שהוא נכנס לתור; המירו את התמונות קודם.
- הוספת שדה קישור לפוסט ב-Instagram. לפוסטים ב-Instagram אין קישור, לכן הבקשה נדחית; שימו את כתובת ה-URL בטקסט.
- הצגת כפתור מענה להודעות ישירות ישנות מ-24 שעות. Meta מאפשרת מענה רק בתוך החלון שההודעה האחרונה של האדם פתחה.
- שליחת תגובה פרטית שנייה לאותה תגובה. Meta מאפשרת אחת; המשך ממתין עד שהאדם עונה.
easyCoexistence מאפשר ללקוחות שלכם לחבר את Instagram לאפליקציה שלכם דרך כניסה מאוחסנת אחת, ואז נותן לשרת שלכם אסימון מתחדש, נקודת הקצה לפוסטים, ואת התגובות וההודעות הישירות דרך וובהוק, כשכל חיבור מנוטר 24/7. אותן קריאות מכסות את WhatsApp, Facebook, TikTok, YouTube ו-LinkedIn, וערוצים נוספים מצטרפים לאותו מחבר. US$ 9 עד US$ 0.75 לכל חיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם אני צריך אפליקציה משלי ב-Meta כדי לחבר חשבונות Instagram של לקוחות?
לא. הלקוחות נכנסים דרך האפליקציה של easyCoexistence, והשרת שלכם מקבל את האסימון של ה-Instagram API של Meta דרך קריאת פרטי הגישה.
האם לקוח יכול לחבר כמה חשבונות Instagram?
כן, אחד בכל כניסה. צרו סשן חיבור לכל חשבון עם אותו external_ref, וקריאת GET /channels?external_ref= מציגה את כולם לאותו לקוח.
האם האפליקציה שלי יכולה לתזמן סטוריז ב-Instagram?
כן. מגדירים את ig_type לערך STORIES עם תמונה או סרטון אחד ועם זמן publish_at, והתור מפרסם אותו אז.
כמה עולה easyCoexistence לכל חשבון Instagram?
כל חשבון מחובר עולה US$ 9 עד US$ 0.75 לחודש, לפי המדרגה של סך החיבורים שלכם, עם 3 הימים הראשונים בחינם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-