התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

איך לאפשר ללקוחות לחבר Instagram לאפליקציה שלכם

השרת שלכם קורא לנקודת הקצה POST /connect-sessions של easyCoexistence עם channel instagram, ושולח את הלקוח לכתובת ה-URL שמוחזרת, שם הוא נכנס עם Instagram Login בחשבון Business או Creator. הוא חוזר לכתובת redirect_url שלכם עם channel_id, ו-GET /channels/{id}?credentials=1 מחזיר אסימון עבור graph.instagram.com, כך שהאפליקציה שלכם יכולה לפרסם, לקרוא תגובות ולהשיב להודעות ישירות.

100 posts

מספר הפוסטים שחשבון Instagram יכול לפרסם דרך ה-API בחלון נע של 24 שעות; קרוסלה נספרת כאחד.

JPEG

Meta מאפשרת לפרסם ב-Instagram דרך ה-API רק תמונות מסוג JPEG בלבד.

24 hours

חלון המענה הסטנדרטי להודעה ישירה של אדם ב-Instagram, ברוב פעולות המשתמש; האדם חייב לכתוב ראשון.

1 private reply

הודעות שחשבון יכול לשלוח למגיב בתגובה פרטית, בתוך 7 ימים מהתגובה.

1 hour

משך הזמן שקישור החיבור של easyCoexistence פעיל לפני שהסשן שלו פג.

מה הלקוח עושה כדי להתחבר?

הלקוח לוחץ על כפתור אחד. האפליקציה שלכם יוצרת את הסשן כשהערך של channel הוא instagram, עם redirect_url, ומזהה הלקוח שלכם כ-external_ref, ואז שולחת את הלקוח לכתובת שהוחזרה. הדף המאוחסן מציג את שם העסק שלכם ואת הכפתור Continue with Instagram, שפותח את הכניסה של Instagram עצמה באותה לשונית, כך שזה עובד גם בטלפונים. הלקוח מאשר את הגישה וחוזר לכתובת redirect_url עם status=connected ועם channel_id, ואתם מאמתים זאת עם GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_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 ימים קדימה.

A carousel on the customer's Instagram account
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

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 הימים הראשונים בחינם.

המשיכו לקרוא

ממשק API לרשתות חברתיות תחת המותג שלכם: פרסום, תגובות והודעות ב-SaaS שלכםהוסיפו פרסום, תשובות לתגובות והודעות פרטיות ל-SaaS שלכם: מה הלקוחות רואים, איפה השם easyCoexistence עדיין מופיע והקריאות שמאחוריו.איך מוסיפים פרסום ב-TikTok ל-SaaS שלכםהוסיפו פרסום ב-TikTok ל-SaaS: חברו את חשבון TikTok של כל לקוח, פרסמו סרטונים או תמונות עכשיו או מאוחר יותר בקריאה אחת, ועקבו עד לפרסום.איך מוסיפים WhatsApp ל-SaaS עם Embedded Signup ו-Coexistenceהוסיפו WhatsApp ל-SaaS: חברו מספרים של לקוחות עם Embedded Signup ו-Coexistence, קבלו הודעות, השיבו בחלון של 24 שעות ושלחו תבניות.איך מחברים חשבון Instagram ל-API או לסוכן AIאיך מחברים חשבון Instagram ל-API או לסוכן AI: כניסה דרך Instagram Login, מה עושה כל הרשאה, והפעלת גישה להודעות וקישורי חיבור מאוחסנים.הודעות DM ב-Instagram דרך ה-API וחלון ההודעות של 24 שעותאיך פועלות הודעות DM ב-Instagram דרך ה-API: למי אפשר לכתוב, חלון 24 השעות, תגובות פרטיות והגדרת הגישה להודעות.איך מקבלים בוובהוק (Webhook) את הודעות WhatsApp ואת התגובות ברשתות החברתיות של הלקוחות שלכםוובהוק לכל חיבור: הודעות WhatsApp ישירות מ-Meta, מאומתות בסוד בכתובת, ותגובות ו-DM מהרשתות החברתיות חתומות בכותרת X-EC-Signature.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-