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

קריאת היסטוריית הודעות ישירות ב-Instagram: ה-Conversations API

ה-Conversations API של Instagram קורא היסטוריית הודעות ישירות של חשבון מקצועי בכתובת graph.instagram.com. GET /me/conversations?platform=instagram מציג את השיחות עם updated_time שלהן, GET /<CONVERSATION_ID>?fields=messages מציג את ההודעות של שיחה לפי ID וזמן, וקריאת GET /<MESSAGE_ID>?fields=id,created_time,from,to,message מחזירה הודעה אחת. פרטים זמינים עבור 20 ההודעות האחרונות בכל שיחה.

easyCoexistence מעביר הודעות DM חדשות של Instagram לנקודת הקצה שלכם ברגע שהן מגיעות ומשיב עם send_social_dm בתוך חלון 24 השעות, מתוך Claude, ChatGPT או הקוד שלכם, דרך ה-API הרשמי של Meta; אין לו כלי להיסטוריה של ה-Conversations API.

20

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

30 days

חוסר פעילות שאחריו שיחות בתיקיית Requests כבר לא מוחזרות.

2/sec

קריאות Conversations API שאפליקציה יכולה לבצע בשנייה, לכל חשבון Instagram מקצועי.

2 permissions

instagram_business_basic ו-instagram_business_manage_messages, עם אסימון של מי שיכול לנהל את ההודעות של החשבון.

איך מציגים את השיחות של חשבון?

עם GET /me/conversations או /<IG_ID>/conversations, עם platform=instagram, באמצעות אסימון גישה (Access Token) של Instagram User של מי שיכול לנהל הודעות בחשבון. כל רשומה במערך data היא שיחה אחת, עם השדות id ו-updated_time שלה.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

איך מוצאים את השיחה עם אדם אחד?

מוסיפים את user_id עם המזהה של אותו אדם בהיקף Instagram, כלומר ה-IGSID שמגיע בשדה sender.id כשהוא שולח הודעה לחשבון, והתגובה מחזירה את השדה id של השיחה הזו. כך הופכים אירוע וובהוק (Webhook) לשרשור שלו בלי לעבור על כל הרשימה.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

איך קוראים את ההודעות?

בשני שלבים. GET /<CONVERSATION_ID>?fields=messages מציג את ההודעות של השיחה לפי id ו-created_time, שהם השדות שמוחזרים כברירת מחדל. לאחר מכן קריאת GET /<MESSAGE_ID> עם fields=id,created_time,from,to,message מחזירה הודעה אחת: מי שלח אותה ולמי, כל אחד עם username ו-ID, והטקסט שלה.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

עד כמה אפשר לקרוא אחורה?

התיעוד של Meta וסקירת ה-API קובעים ארבע מגבלות על מה שחוזר:

  • פרטי הודעות: 20 ההודעות האחרונות בכל שיחה; בקשה להודעה ישנה יותר מחזירה שגיאה שאומרת שההודעה נמחקה.
  • Requests: שיחות בתיקיית Requests ללא פעילות במשך 30 ימים לא מוחזרות.
  • שיתופים: פוסט או Reel ששותפו חוזרים רק ככתובת ה-URL של התמונה או הווידאו.
  • קצב: 2 קריאות בשנייה לכל חשבון Instagram מקצועי.

מה נדרש לכך?

עם Instagram Login, ההרשאות instagram_business_basic ו-instagram_business_manage_messages ואסימון של מי שיכול לנהל הודעות בחשבון. Standard Access מספיק לחשבונות שאתם הבעלים שלהם או מנהלים אותם ושהוספתם לאפליקציה, ולשרת חשבונות אחרים דורש Advanced Access. בהגדרות החשבון ב-Instagram צריך גם להפעיל את האפשרות Allow access to messages.

למה לשמור רשומה מאירועי וובהוק?

כי ה-API מחזיר פרטים רק על 20 ההודעות האחרונות של כל שיחה, לכן יש לשמור את ההיסטוריה המלאה תוך כדי שהיא מתרחשת. וובהוק ההודעות (messages) מעביר הודעות DM ברגע שהן מגיעות, עם ה-IGSID של האדם בשדה sender.id, ובנוסף מגיעות הודעות שהחשבון שולח, עם המזהים בכיוון ההפוך, כך ששני הצדדים של השיחה יכולים להירשם.

איך קוראים היסטוריית DM דרך easyCoexistence?

הוא מעביר הודעות DM ולא קורא היסטוריה. הודעות DM חדשות מגיעות לנקודת הקצה שלכם כשהן מתקבלות, לאחר שמגדירים אותה עם set_social_webhook_destination, והן מועברות הלאה בלי שנשמר עותק; הכלי send_social_dm משיב בתוך חלון 24 השעות, מתוך Claude, ChatGPT או הקוד שלכם. אף כלי לא קורא את me/conversations, ולכן הודעות קודמות נקראות באפליקציית Instagram, או נשמרות במערכת שלכם עם הגעתן.

טעויות נפוצות

  • לצפות לשרשור המלא מה-API. הפרטים נעצרים ב-20 ההודעות האחרונות, לכן יש לשמור הודעות DM מוובהוק ההודעות (messages) ברגע שהן מגיעות.
  • שליפה חוזרת של שיחות כדי למצוא הודעות DM חדשות. ה-API מאפשר 2 קריאות בשנייה לכל חשבון, בעוד שוובהוק ההודעות מעביר כל הודעת DM ברגע שהיא מגיעה.
  • חיפוש בקשת הודעה ישנה. שיחות בתיקיית Requests עם 30 ימים של חוסר פעילות כבר לא מוחזרות.
  • לפרש את השגיאה שההודעה נמחקה כאילו האדם מחק אותה. Meta עונה כך על כל הודעה ישנה מעבר ל-20 האחרונות.
עושים את זה עם EasyCoexistence

US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

האם אפשר לייצא את כל היסטוריית ההודעות הישירות של חשבון Instagram?

לא במלואה דרך ה-API: הוא מציג את השיחות אבל מחזיר פרטים רק על 20 ההודעות האחרונות בכל שיחה. רשומה מלאה נוצרת מכך ששומרים הודעות DM כשוובהוק מעביר אותן.

האם קריאת הודעות דרך ה-API מסמנת אותן כנקראות?

לא. Meta מציינת שהודעות שמועברות דרך ה-API לא מסומנות כנקראות באפליקציית Instagram עד שנשלחת תשובה.

האם Conversations API עובד עם Instagram Login?

כן. המדריך של Meta ל-Conversations API נכתב עבור Instagram Login, והוא כולל קריאות אל graph.instagram.com ואת ההרשאות של instagram_business הנדרשות.

איך מקבלים את שם המשתמש של אדם מתוך שיחה?

מבקשים את השדה from בהודעה, והוא מחזיר את שם המשתמש ואת ה-ID של השולח. ה-User Profile API מחזיר יותר, כמו השם, לפי ה-IGSID שלו לאחר שהוא שלח הודעה לחשבון.

המשיכו לקרוא

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

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

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

נבדק ב-