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

Messenger Send API: שליחת הודעות מעמוד פייסבוק

עמוד פייסבוק שולח הודעות Messenger באמצעות POST /{page-id}/messages ואסימון גישה (Access Token) של העמוד. השדה recipient מכיל את המזהה הייחודי לעמוד (PSID) של האדם. messaging_type הוא RESPONSE או UPDATE בתוך חלון המענה הסטנדרטי, או MESSAGE_TAG אחריו. השדה message מכיל טקסט או קובץ מצורף, כמו תמונה, אודיו, וידאו או קובץ. Meta עונה עם השדה recipient_id ועם השדה message_id.

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

300 per second

קריאות Send API שאפליקציה יכולה לבצע לכל עמוד להודעות עם טקסט, קישורים, ריאקשנים וסטיקרים.

10 per second

קריאות Send API שאפליקציה יכולה לבצע לכל עמוד להודעות שמכילות אודיו או וידאו.

25 MB

הנכס הגדול ביותר ש-Messenger Platform שומר לשימוש חוזר; תמונה שמועלית מכתובת ה-URL מוגבלת ל-8 MB.

30 images

מספר התמונות המרבי שהודעה אחת יכולה לשאת במערך attachments, סוג המדיה היחיד שמותר שם.

90 days

משך הזמן שבו attachment_id שמור תקף, לפני שיש להעלות את המדיה מחדש.

מה בקשת Send API כוללת?

Meta מונה שישה רכיבים שחייבים להופיע בשליחה: מזהה העמוד השולח, מזהה האדם המקבל, אסימון הגישה של אותו עמוד, הרשאה מהאדם, סוג ההודעה והתוכן. הבקשה היא POST של JSON אל /{page-id}/messages, ותשובה לאדם ששלח הודעה זה עתה נראית כך:

A text reply, and Meta's answer
POST /{page-id}/messages
{
  "recipient": { "id": "<PSID>" },
  "messaging_type": "RESPONSE",
  "message": { "text": "Your order ships tomorrow." }
}

{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }

איזה מזהה נכנס לשדה recipient?

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

  • id: ה-PSID, ייחודי לאותו אדם ולאותו עמוד.
  • user_ref: לאדם שהשתמש בפלאגין או בכפתור postback כדי לשלוח הודעה לעמוד.
  • comment_id או post_id: לתשובה פרטית לתגובה, או לפוסט שמבקר פרסם בעמוד.
  • מזהים מ-Facebook Login הם מוגבלים לאפליקציה ולא עובדים ב-Messenger Platform.

איזה messaging_type צריך להגדיר להודעה?

הסוג אומר ל-Meta מדוע ההודעה נשלחת, והוא קובע מתי השליחה מותרת. דף העזר של Meta להודעות עמוד מפרט ארבעה ערכים:

  • RESPONSE: תשובה להודעה שהעמוד קיבל, שיווקית או לא, בתוך חלון המענה הסטנדרטי.
  • UPDATE: הודעה שהעמוד שולח ביוזמתו, שיווקית או לא, גם היא בתוך אותו חלון.
  • MESSAGE_TAG: הודעה לא שיווקית שנשלחת אחרי החלון, עם תג שמתאים לשימוש מאושר.
  • UTILITY: הודעה תפעולית שנבנתה מתבנית מאושרת, למשל עדכון על הזמנה או פגישה.

מה הודעה יכולה לכלול?

טקסט, או אובייקט attachment אחד עם סוג ו-payload: קבצים מצורפים מסוג תמונה, אודיו, וידאו וקובץ מפנים לכתובת ה-URL או למזהה attachment_id שמור, וקבצים מצורפים מסוג תבנית נושאים הודעות מובנות עם כפתורים. אותה נקודת הקצה מקבלת גם את אלה:

  • attachments: מערך של עד 30 תמונות שנשלחות כהודעה אחת.
  • reply_to עם mid: תשובה להודעה מסוימת קודמת, של האדם או של העמוד.
  • quick_replies: עד 13 כפתורים מעל שדה ההקלדה, כשלכל כותרת עד 20 תווים.
  • sender_action: אינדיקציה להקלדה, סימון צפייה או ריאקשן, שנשלחת בבקשה נפרדת מההודעה עצמה.
  • notification_type: ברירת המחדל היא REGULAR, או SILENT_PUSH או NO_PUSH.

כמה גדולים יכולים להיות קבצים מצורפים?

ההנחיה של Meta לשמירת נכסים קובעת את המגבלות למדיה שפלטפורמת Messenger שולפת ושומרת: נכסים עד 25 MB, תמונות עד 8 MB כשמועלות מכתובת ה-URL, אודיו שנשלח עם Content-Type של אודיו, וידאו שנשלף תוך 75 שניות. הגדרת is_reusable לערך true מחזירה attachment_id שרק העמוד ששלח אותו יכול להשתמש בו שוב, למשך 90 יום, ו-POST /{page-id}/message_attachments מעלה מדיה מראש.

מהן מגבלות הקצב של Send API?

Meta סופרת אותן לפי עמוד ולפי סוג התוכן. דף העזר של Meta להודעות עמוד מפרט, בין שגיאות השליחה, את 613, שמשמעותה שהקריאות חרגו ממגבלת הקצב, ולכן כשהיא מופיעה כדאי להאט ולא לנסות מיד שוב:

  • 300 קריאות בשנייה לכל עמוד להודעות עם טקסט, קישורים, ריאקשנים וסטיקרים.
  • 10 קריאות בשנייה לכל עמוד להודעות עם אודיו או וידאו.
  • הודעות רבות לשיחה אחת עשויות להיות מוגבלות בקצב גם בלי קשר לעמוד.
  • סך קריאות Messenger API: פי 200 ממספר המשתמשים המעורבים, בחלון מתגלגל של 24 שעות.
  • מעל 40 הודעות בשנייה, תיבת הנכנסות של העמוד מפסיקה להציג הודעות חדשות, והעמוד לא יכול לשלוח עד שהנפח יורד.

אילו שגיאות מחזיר Send API?

טבלת השגיאות של Messenger ב-Meta מזווגת כל קוד עם תת-קוד שמציין את הסיבה. אלה השגיאות שעמוד נתקל בהן לעיתים קרובות בזמן שליחה:

  • 10 עם 2018278 או 2534022: ההודעה נשלחת מחוץ לחלון המותר.
  • 10 עם 2018300: אפליקציה אחרת שולטת בשיחה.
  • 100: פרמטר לא תקין, למשל מזהה recipient שגוי; תת-הקוד 2018001 מציין: לא נמצא משתמש תואם.
  • 551: האדם אינו זמין, ייתכן משום שחסם את העמוד או השבית את החשבון; 200 עם 1545041 מציין: האדם אינו זמין כרגע.
  • 200 עם 2018028: האפליקציה לא יכולה לשלוח הודעות לאנשים שמחוץ לתפקידיה, עד שההרשאה pages_messaging תאושר והאפליקציה תהיה פעילה.
  • 10904: בהגדרות העמוד השליחה של ההודעות כבויה.

איך easyCoexistence שולח דרכו?

send_social_dm מקבל את account_id, את recipient_id של האדם, שהוא sender.id באירוע הודעות שהועבר, ואת הטקסט, ושולח אותם אל /{page-id}/messages עם messaging_type מסוג RESPONSE. התוצאה היא התשובה של Meta עם message_id, ושליחה שנדחתה חוזרת עם קוד השגיאה והודעת השגיאה של Meta. מדיה, תשובות מהירות, תבניות ו-sender_action אינם בין הכלים: send_social_dm שולח טקסט.

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

  • שליחת אינדיקציה להקלדה יחד עם ההודעה. Meta רוצה שהשדה sender_action יופיע לבד עם הנמען, והטקסט או התבניות יישלחו בבקשה נפרדת.
  • שליחת פרץ הודעות לאדם אחד. Meta עשויה להגביל שיחה בודדת בפני עצמה, בנפרד מ-300 הקריאות בשנייה של העמוד.
  • שליחת אודיו או וידאו בקצב של טקסט. הודעות עם אודיו או וידאו מוגבלות ל-10 קריאות בשנייה לכל עמוד.
  • שימוש חוזר במזהה attachment_id ישן מ-90 יום. מזהי קבצים מצורפים שמורים פגים, ולכן יש להעלות את המדיה מחדש כדי לקבל מזהה חדש.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם Messenger Send API חינמי?

כן, להודעות רגילות. מסמך הסקירה של Meta קורא ל-Messenger Platform חינמי לשימוש, ולכן עמוד שמגיב לאנשים שכתבו לו לא משלם דבר על כל הודעה; הודעות שיווק מחויבות לפי כל הודעה.

איזו משימת עמוד נדרשת כדי לשלוח הודעה?

סקירת Messenger של Meta מבקשת אסימון עמוד ממי שיכול לבצע את המשימות MESSAGING ו-MODERATE, כשההרשאה pages_messaging ניתנה.

האם easyCoexistence יכול להשיב בתמונות ב-Messenger?

לא היום. send_social_dm שולח טקסט, ואף כלי אינו שולח קובץ מצורף.

כמה עולה easyCoexistence לעמוד פייסבוק?

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

המשיכו לקרוא

הודעות תגית ב-Messenger בשנת 2026: מה דף Facebook יכול לשלוח אחרי חלון 24 השעותמה דף Facebook יכול לשלוח אחרי חלון 24 השעות של Messenger ב-2026: HUMAN_AGENT, CUSTOMER_FEEDBACK, שלוש תגיות שהופסקו והתחליפים שלהן.קריאת היסטוריית שיחות Messenger דרך ה-APIקריאת היסטוריית Messenger של עמוד Facebook עם Conversations API: /{page-id}/conversations, שדות הודעה, מגבלת 20 הודעות והרשאות.חלון ההודעות של 24 שעות ב-Messenger: מתי עמוד Facebook יכול לשלוח הודעהמתי עמוד Facebook יכול לשלוח הודעה ב-Messenger: חלון ההודעות הרגיל של 24 שעות, הפעולות שפותחות אותו, ועד 7 ימים אחרי מודעה.פרוטוקול ההעברה ב-Messenger: שיתוף תיבת הדואר של הדף בין סוכן AI לאנשיםאיך השיחות של דף Facebook עוברות בין אפליקציות לתיבת הדואר של הדף: ניתוב שיחות, pass_thread_control ובעלי השיחה.שגיאה 10 ב-Facebook: הרשאה נדחתה או הודעה מחוץ לחלון המותרשגיאה 10 ב-Facebook: לאפליקציה אין הרשאה לפעולה, או ב-Messenger: ההודעה נשלחה מחוץ לחלון המותר. הנה תיקון לשניהם.שגיאה 551 של Facebook: האדם אינו זמין ב-Messengerשגיאה 551 ב-Facebook: Messenger לא הצליח להגיע לאדם שאולי חסם את הדף או השבית את חשבונו, וההודעה לא נשלחה.

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

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

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

נבדק ב-