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

פרוטוקול ההעברה ב-Messenger: שיתוף תיבת הדואר של הדף בין סוכן AI לאנשים

פרוטוקול ההעברה ב-Messenger הוחלף בניתוב שיחות (Conversation Routing), שממשיך לתמוך בקריאות השליטה בשיחה: pass_thread_control מעביר שיחה לאפליקציה אחרת, כמו תיבת הדואר של הדף עם מזהה האפליקציה 263902037430900, take_thread_control תופס אותה, request_thread_control מבקש אותה, ואילו release_thread_control מחזיר אותה למצב לא פעיל. כשהניתוב פועל, האפליקציה ששולטת בשיחה מקבלת את ההודעות שלה, והאחרות מקבלות אותן בערוץ ה-standby.

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

263902037430900

מזהה target_app_id שמספקת Meta להעברת שליטה בשיחה לתיבת הדואר של הדף.

2018300

תת-קוד של שגיאה 10, עבור הודעה שנכשלה משום שאפליקציה אחרת שולטת בשיחה.

24 hours

אם הלקוח לא שלח הודעה במשך פרק הזמן הזה, השיחה הופכת ללא פעילה, ואז רק אפליקציית ברירת המחדל יכולה לשלוח.

Up to 7 days

עד כמה הפונקציה extend_thread_control יכולה להאריך את שליטת האפליקציה מעבר לחלון התגובה של 24 שעות.

Off by default

השתלטות על שיחות עם ה-Business AI שלכם. כשהאפשרות כבויה, הודעות ללא תג לשיחה עם Business AI נכשלות עם שגיאה 10 ותת-קוד 2018300.

מה קרה לפרוטוקול ההעברה?

הוא שולב בניתוב שיחות. המדריך מציין שפרוטוקול ההעברה ל-Messenger כבר אינו נתמך, שעסקים הועברו לניתוב שיחות, ושהניתוב תואם לאחור לרוב קריאות פרוטוקול ההעברה. לכן pass_thread_control, take_thread_control והוובהוק (Webhook) messaging_handovers אמורים להמשיך לעבוד. מה שהשתנה הוא מי מחליט: העסק מגדיר אפליקציית ברירת מחדל וכללי ניתוב בהגדרות הדף, תחת ניתוב שיחות.

מי שולט בשיחה?

אפליקציה אחת בכל פעם, שמכונה על ידי Meta בעל השיחה (thread owner). שיחה פעילה כשהלקוח והאפליקציה שמחזיקה בה מדברים, ולא פעילה כשהלקוח לא כתב במשך 24 שעות או כשהאפליקציה שחררה את השליטה. בשיחה לא פעילה רק אפליקציית ברירת המחדל יכולה לשלוח, בתוך חלון ההודעות. כללי הניתוב קובעים מי לוקח שיחה:

  • אפליקציית ברירת מחדל: זו שעונה כשלא הוגדרה אפליקציה אחרת, או כשזו אינה עונה.
  • ניתוב חברתי: האפליקציה שלוקחת שליטה כשהלקוח פותח שיחה לא פעילה או לוחץ על Get Started.
  • ניתוב קישורים: אפליקציה שמוקצית לכל קישור m.me.
  • ניתוב קמפיינים: האפליקציה שנבחרה למודעת Click-to-Messenger, ששולטת בשיחה בתוך חלון ההודעות של השיחה, עד 7 ימים.

אילו קריאות מעבירות שליטה בין אפליקציות?

כל אחת היא בקשת POST לנקודת הקצה של הדף, כאשר השדה recipient מכיל את ה-PSID של הלקוח, וכל אחת מחזירה success true. רוב הקריאות מקבלות גם מחרוזת metadata, שהאפליקציה הבאה מקבלת:

  • pass_thread_control: מעביר את השיחה לאפליקציה שמזוהה לפי target_app_id, והיא מקבלת אירוע messaging_handovers.
  • release_thread_control: מסיים את השליטה של האפליקציה ומחזיר את השיחה למצב לא פעיל.
  • take_thread_control: הופך את האפליקציה הקוראת לבעלים, לאפליקציות שהעסק מתיר להן לקחת שליטה.
  • request_thread_control: מבקש שליטה בשיחה.
  • extend_thread_control: שומר על השליטה מעבר לחלון התגובה של 24 שעות, עד 7 ימים, כשמשך הזמן נתון בשניות.
  • ה-Send API יכול להעביר או לשחרר שליטה יחד עם ההודעה עצמה, דרך אובייקט thread_control.
Handing a conversation to the Page Inbox
POST /{page-id}/pass_thread_control
  ?recipient={id:<PSID>}
  &target_app_id=263902037430900
  &metadata=Customer asked for a person

{ "success": true }

איך אנשים נכנסים לתיבת הדואר של הדף?

על ידי מענה. ניתוב שיחות מתייחס לתיבת Meta Business Suite כאל עוד אפליקציה מחוברת, שהעסק יכול אפילו להפוך אותה לברירת המחדל. כשמישהו עונה שם בשיחה שהתיבה אינה שולטת בה, או מעביר אותה לתיקייה Main, התיבה לוקחת שליטה. אפליקציה מעבירה שיחה לאנשים באמצעות pass_thread_control, כשהשדה target_app_id הוא 263902037430900, ואפליקציה ששולחת תשובה של לקוח אחרי חלון של 24 שעות שולחת אותה עם התג HUMAN_AGENT, בתוך 7 ימים מההודעה האחרונה של הלקוח.

1AI agentThe app that owns the thread replies to the person
2Hand overpass_thread_control to 263902037430900
3Page inboxPeople answer; a reply there also takes control
4IdleReleased, or 24 hours without a message from the person

מה קורה כש-Business AI של Meta שולט בשיחה?

אפליקציות אחרות מקבלות את ההודעות של הלקוח בערוץ ה-standby ואינן אמורות לענות עליהן. לפי המדריך של Meta, מתחילים להגיב אחרי אירוע messaging_handovers עם pass_thread_control. הודעת messages עשויה לכלול את השדה admin_text ואת השדה handoff_reason, כמו human_requested או purchase_intent, אך היא לא מעבירה בעלות. כשהאפשרות Take control of conversations with your Business AI כבויה, שהיא ברירת המחדל, שליחה ללא תג לשיחה הזאת נכשלת עם קוד שגיאה 10, תת-קוד 2018300.

איך אפליקציה בודקת מי בעל השיחה?

הקריאה GET /{page-id}/thread_owner, כשהשדה recipient מכיל את ה-PSID, מחזירה את השדה app_id של האפליקציה שמחזיקה בשיחה ואת מועד פקיעת השליטה שלה, לאפליקציה עצמה או לאפליקציית ברירת המחדל של הדף. השדה is_owner ב-Conversations API עונה על אותה שאלה לכל שיחה בנפרד, כשהניתוב פועל. הקריאה GET /{page-id}?fields=messaging_feature_status מציגה את סטטוס ניתוב השיחות של הדף בשדות כמו msgr_multi_app.

מה קורה בלי ניתוב שיחות?

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

מה עושה easyCoexistence בתיבה משותפת?

הוא נרשם לקבלת feed, messages וגם mention של כל דף, ולא לאירועים messaging_handovers, standby או message_echoes. כך מועברות הודעות הלקוח, בעוד האפליקציה עצמה מקבלת אותן. היא אינה רואה אירועי העברה ולא תשובות שנשלחו מתיבת הדואר של הדף. הכלי send_social_dm שולח RESPONSE בלי thread_control, וכשהשליחה נדחית כי אפליקציה אחרת מחזיקה בשיחה, הכלי מחזיר ל-AI שלכם את קוד השגיאה 10 ואת ההודעה של Meta. קריאות בקרת השליטה, הקריאה thread_owner והשדה is_owner אינן נמצאות בין הכלים שלו.

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

  • מענה להודעות standby. הן מגיעות לאפליקציה שאינה בעלת השיחה, ולכן יש לחכות ל-pass_thread_control לפני מענה.
  • קריאת admin_text כהעברה. הודעת messages שכוללת הקשר העברה אינה מעבירה בעלות; האירוע messaging_handovers כן.
  • הרצת AI ותיבת הדואר זו לצד זו בלי ניתוב. בברירת המחדל שניהם מקבלים את ההודעה, וההמלצה של Meta היא לתאם ביניהם כדי למנוע שתי תשובות.
  • החזקת שיחה אחרי שהזרימה מסתיימת. ההמלצה היא לשחרר את השליטה ברגע שהאפליקציה סיימה את עבודתה, ולא לחכות שזמן התגובה יפוג.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם שתי אפליקציות על דף אחד צריכות ניתוב שיחות?

ההמלצה של Meta היא לעשות זאת כשמחוברות כמה אפליקציות הודעות, וכל אחת אמורה לענות על שיחות מסוימות. עם אפליקציה אחת שמקבלת ועונה, ברירת המחדל מספיקה.

כמה זמן אפליקציה שומרת על השליטה בשיחה?

עד שהיא משחררת את השליטה, או עד שהשיחה הופכת ללא פעילה, 24 שעות אחרי ההודעה האחרונה של הלקוח. הפונקציה extend_thread_control מוסיפה זמן, עד 7 ימים.

האם תשובה מתיבת הדואר של הדף מגיעה לאפליקציות אחרות?

אפליקציות שנרשמו לאירוע message_echoes מקבלות אותה כהד (echo), שבו השדה app_id הוא של תיבת הדואר של הדף, 263902037430900, כפי שמתואר ביומן השינויים של Meta עבור Graph API v12.0 ומעלה.

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

כשניתוב שיחות פועל, תיבת הדואר לוקחת שליטה. עד שהשליטה תחזור, הודעות הלקוח מגיעות לאפליקציה של easyCoexistence רק בערוץ ה-standby, שאליו האפליקציה אינה נרשמת. בלי ניתוב, שתיהן ממשיכות לקבל אותן.

המשיכו לקרוא

Messenger Send API: שליחת הודעות מעמוד פייסבוקאיך עמוד פייסבוק שולח הודעות Messenger עם POST /{page-id}/messages: מזהה ה-PSID, messaging_type, טקסט וקבצים מצורפים, מגבלות קצב ושגיאות.הודעות תגית ב-Messenger בשנת 2026: מה דף Facebook יכול לשלוח אחרי חלון 24 השעותמה דף Facebook יכול לשלוח אחרי חלון 24 השעות של Messenger ב-2026: HUMAN_AGENT, CUSTOMER_FEEDBACK, שלוש תגיות שהופסקו והתחליפים שלהן.קריאת היסטוריית שיחות Messenger דרך ה-APIקריאת היסטוריית Messenger של עמוד Facebook עם Conversations API: /{page-id}/conversations, שדות הודעה, מגבלת 20 הודעות והרשאות.שדות וובהוק (Webhook) של עמוד Facebook: הרשימה המלאה64 שדות וובהוק לעמוד Facebook שאותם מתעדת Meta: feed, mention, שדות Messenger ושדות פרופיל, וההרשאה שכל אחד דורש.וובהוק (Webhook) של Messenger לעמודי Facebook: הודעות ואזכוריםשדות הוובהוק של עמודי Facebook להודעות Messenger ולאזכורים: מבנה ה-payload, מזהי השולחים, קבצים מצורפים ודרך המסירה לנקודת הקצה.שגיאה 10 ב-Facebook: הרשאה נדחתה או הודעה מחוץ לחלון המותרשגיאה 10 ב-Facebook: לאפליקציה אין הרשאה לפעולה, או ב-Messenger: ההודעה נשלחה מחוץ לחלון המותר. הנה תיקון לשניהם.

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

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

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

נבדק ב-