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

קריאת היסטוריית שיחות Messenger דרך ה-API

היסטוריית Messenger של עמוד Facebook נקראת עם GET /{page-id}/conversations?platform=messenger, שמחזיר מזהי שיחות וזמן העדכון האחרון של כל אחת. לאחר מכן GET /{conversation-id}?fields=messages מחזיר את מזהי ההודעות, ו-GET /{message-id} מחזיר לכל הודעה את השולח, הנמען, הטקסט והקבצים המצורפים. Meta מחזירה פרטים רק עבור 20 ההודעות האחרונות בשיחה, והקריאות דורשות אסימון גישה (Access Token) של העמוד עם pages_messaging שמאשר את הגישה להודעות.

easyCoexistence מעבירה לנקודת הקצה שלכם את ההודעות החדשות ב-Messenger של עמוד ברגע שהן מגיעות, ו-send_social_dm משיב בתוך חלון ה-24 שעות, מ-Claude, מ-ChatGPT או מהקוד שלכם.

20 messages

רק 20 ההודעות האחרונות בשיחה מחזירות פרטים; הודעות ישנות יותר מחזירות שגיאה שמציינת שההודעה נמחקה.

2 per second

מספר הקריאות ל-Conversations API שאפליקציה יכולה לבצע לכל עמוד Facebook.

30 days

שיחות בתיקיית Requests שלא היו פעילות במשך פרק הזמן הזה אינן נכללות בתוצאות ה-API.

MESSAGING or MODERATE

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

80006

שגיאה על יותר מדי קריאות Messenger API לחשבון עמוד; Meta ממליצה להמתין מעט ולנסות שוב.

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

עם GET /{page-id}/conversations, כאשר הערך של platform הוא messenger. התוצאה כוללת מערך data של מזהי שיחות. לכל שיחה יש שדה updated_time, שמציין מתי נוסף אליה ההודעה האחרונה, ואובייקט paging. בתיעוד של Meta נכתב שדפדוף לפי זמן אינו זמין בנקודת הקצה הזו, ולכן כדי לעבור על הרשימה יש לעקוב אחרי האובייקט paging שבתשובה.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

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

מוסיפים לאותה בקשה את user_id, שערכו הוא מזהה ה-Page-scoped של האדם. Meta משיבה במזהה השיחה בין העמוד לאדם, וזו הדרך הקצרה ביותר מוובהוק (Webhook) של הודעות, שבו מגיע ה-PSID בתור sender.id, אל היסטוריית השיחה שמאחוריו:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

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

בשני שלבים. GET /{conversation-id} עם fields=messages מחזיר את מזהי ההודעות בשיחה, ולכל אחד created_time, מהחדשה לישנה. לאחר מכן GET /{message-id} עם השדות שצריך, כמו id, created_time, from, to, message ו-reply_to, מחזיר את התוכן של הודעה אחת. השדות ברירת המחדל הם id ו-created_time, ושדה שאין לו נתונים לא נכלל בתשובה.

אילו שדות אפשר לקרוא?

שיחה והודעה חושפות שדות שונים. אלה השדות שמופיעים בתיעוד של Meta להודעות של עמוד:

  • שיחה: id, updated_time, participants עם המזהה, השם והאימייל שלהם, messages, ו-is_owner ברגע ש-Conversation Routing פעיל.
  • הודעה: id, created_time, from ו-to, שכל אחד מהם כולל מזהה, שם ואימייל, ו-message שמכיל את הטקסט, וריק כשאין טקסט.
  • attachments: קבצים, תמונות וסרטונים עם כתובות ה-CDN שלהם, ו-is_unsupported, שמוחזר רק כשההודעה מכילה תוכן לא נתמך.
  • reactions; reply_to, שמכיל את mid של ההודעה שאליה משיבים, ו-is_self_reply; ו-shares לפוסטים ולרילס משותפים.
  • tags: התיקייה והמקור של ההודעה, כמו inbox, read או source:chat, לפי הערך שמוחזר.

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

עד תחילת השיחה לגבי מזהים, אבל לא לגבי תוכן. לפי המדריך של Meta, נקודת הקצה של השיחות מחזירה את כל מזהי ההודעות בשיחה, אבל הפרטים חוזרים רק עבור 20 ההודעות האחרונות. בקשה להודעה ישנה יותר מחזירה שגיאה שההודעה נמחקה. שיחות בתיקיית Requests שלא היו פעילות במשך 30 ימים לא מוחזרות בכלל.

אילו הרשאות ומשימות נדרשות?

אסימון גישה של העמוד מאדם שיכול לבצע את המשימה MESSAGING או MODERATE בעמוד, עם ההרשאות pages_manage_metadata, pages_read_engagement ו-pages_messaging. קריאת שיחות עם אנשים שאין להם תפקיד באפליקציה, בעמוד או בעסק דורשת Advanced Access, שמאושרת בתהליך App Review, בדיקה רשמית של האפליקציה.

אילו מגבלות חלות על הקריאות?

מגבלות הקצב של Meta נותנות ל-Conversations API שתי קריאות בשנייה לכל עמוד, וקריאות שחורגות מהמגבלה חוזרות עם 613 או עם 80006, שמציינות שיש יותר מדי קריאות Messenger API לחשבון העמוד הזה. עמוד שמגיע למגבלת הנפח הגבוהה של Meta, כמו שליחת יותר מ-40 הודעות בשנייה, לא יכול להציג את השיחות שלו עד שהנפח יורד, אף שאפשר עדיין לקרוא הודעות חדשות בשיחה בודדת.

מתי להשתמש ב-API ולא בוובהוקים?

לעבר, כלומר להודעות שכבר נשלחו. וובהוקים מעבירים הודעות חדשות ברגע שהן מתרחשות, ו-Meta מציינת שאי אפשר לשאול מאוחר יותר על הודעות שכבר הגיעו, ולכן Conversations API הוא הדרך שבה אינטגרציה קוראת את מה שהיה לפני שהתחילה להאזין, או משלימה אחרי השבתה. כש-Conversation Routing פעיל, השדה is_owner מצמצם את הרשימה לשיחות שהאפליקציה אחראית לענות עליהן, וזו ההמלצה של Meta להתאוששות אחרי השבתה.

איך easyCoexistence קוראת את היסטוריית Messenger?

הוא אינו קורא היסטוריה. העמוד מתחבר עם ההרשאות pages_messaging, pages_manage_metadata ו-pages_read_engagement, אבל אף כלי אינו קורא ל-Conversations API, ואסימוני עמוד אינם נמסרים. הודעות חדשות מגיעות לנקודת הקצה שלכם דרך set_social_webhook_destination ברגע שהן מגיעות, ומועברות הלאה בלי לשמור עותק, כך שהמערכת שלכם שומרת את ההיסטוריה שהיא צריכה.

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

  • ציפייה לתוכן ההודעות בקריאת הרשימה. נקודת הקצה של השיחות מחזירה רק מזהי הודעות, ואת התוכן של כל הודעה צריך לקרוא בבקשה נפרדת לפי מזהה ההודעה.
  • הסתמכות על כל ההיסטוריה. הפרטים נעצרים ב-20 ההודעות האחרונות, ולכן שמרו מוובהוקים את מה שאתם צריכים בזמן שההודעות מגיעות.
  • סקירה חוזרת של הודעות חדשות. ב-2 קריאות בשנייה לכל עמוד, לולאת סקירה נתקלת מהר מדי במגבלת הקצב, ואילו וובהוק ההודעות מעביר אותן ברגע שהן מתרחשות.
  • מיון שיחות לפי תאריך עם since ו-until. דפדוף לפי זמן אינו זמין בנקודת הקצה של השיחות; במקום זה יש לעבור על הרשימה לפי אובייקט הדפדוף שבתשובה.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם Conversations API כולל גם את ההודעות של העמוד עצמו?

כן. השדות from ו-to מציינים את האדם או את העמוד, ולכן השיחה כוללת את שני הצדדים.

אפשר לקרוא שיחות Messenger בלי App Review?

לאנשים שיש להם תפקיד באפליקציה או בעמוד מספיקה Standard Access. שיחות עם כל אחד אחר דורשות Advanced Access, שמאושרת בתהליך App Review, בדיקה רשמית של האפליקציה.

אפשר לשלוח תשובות דרך Conversations API?

לא. לפי התיעוד של Meta, נקודת הקצה של השיחות לא יכולה לפרסם הודעות. תשובות עוברות דרך ה-Send API בנתיב /{page-id}/messages, ושם הן נשלחות.

האם easyCoexistence שומרת את שיחות Messenger שלי?

לא כברירת מחדל. אירועים מועברים הלאה בלי לשמור עותק; כשאוטומציה פעילה, טקסט ההודעה נשמר 7 ימים ויומני ההרצה של האוטומציה נשמרים 30 ימים.

המשיכו לקרוא

Messenger Send API: שליחת הודעות מעמוד פייסבוקאיך עמוד פייסבוק שולח הודעות Messenger עם POST /{page-id}/messages: מזהה ה-PSID, messaging_type, טקסט וקבצים מצורפים, מגבלות קצב ושגיאות.פרוטוקול ההעברה ב-Messenger: שיתוף תיבת הדואר של הדף בין סוכן AI לאנשיםאיך השיחות של דף Facebook עוברות בין אפליקציות לתיבת הדואר של הדף: ניתוב שיחות, pass_thread_control ובעלי השיחה.וובהוק (Webhook) של Messenger לעמודי Facebook: הודעות ואזכוריםשדות הוובהוק של עמודי Facebook להודעות Messenger ולאזכורים: מבנה ה-payload, מזהי השולחים, קבצים מצורפים ודרך המסירה לנקודת הקצה.שדות וובהוק (Webhook) של עמוד Facebook: הרשימה המלאה64 שדות וובהוק לעמוד Facebook שאותם מתעדת Meta: feed, mention, שדות Messenger ושדות פרופיל, וההרשאה שכל אחד דורש.הרשאות דף Facebook API ודרישות App Reviewתשע הרשאות של דף Facebook, מה כל אחת פותחת, ומה Meta דורשת ב-App Review לגישה מתקדמת: אימות עסק וסרטון הקלטה.אסימון גישה לעמוד Facebook: כמה זמן הוא תקף ומה מבטל אותוהסבר איך מקבלים אסימון גישה לעמוד Facebook ללא תאריך תפוגה, מי יכול לקבל אותו, ומה גורם ל-Meta להפסיק לקבל אותו.

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

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

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

נבדק ב-