easyCoexistence
התחברותהתחילו תקופת ניסיון
Meta Tech Provider

וובהוק history

השדה history מעביר ל-API פעם אחת את השיחות הקיימות של מספר Coexistence. הוא מגיע לאחר החיבור, אם אושר שיתוף ההיסטוריה, והוא האות היחיד לאינטגרציה שההעברה התבצעה.

24 hours

החלון לאחר החיבור שבו הסנכרון חייב להתחיל.

2593107

השגיאה שמוחזרת כשהסנכרון כבר נוצל.

2593108

השגיאה שמוחזרת כשמנסים להפעיל אותו מחוץ לחלון.

מה הוא מעביר

היסטוריית הודעות אישיות שכבר הייתה למספר באפליקציית WhatsApp Business, כדי שהתוכנה לא תתחיל בלי הקשר בקו שעסק השתמש בו במשך שנים.

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

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

למה הוא מופעל פעם אחת

כי ההעברה היא חלק מתהליך החיבור, ולא יכולת מתמשכת.

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

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

מה המטפל צריך לעשות עם ההודעה

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

  • מאשרים במהירות ומעבדים באופן אסינכרוני, כמו כל מסירה אחרת.
  • מונעים כפילויות לפי message id: ההיסטוריה והודעות בזמן אמת עשויות לחפוף סביב רגע החיבור.
  • מצפים לכך שהיא לא תגיע. מספר שבעליו דחה את שיתוף ההיסטוריה לא שולח דבר בשדה הזה, והאינטגרציה צריכה לפעול בכל מקרה.
  • אין לעכב את החיבור בגללה. החיבור זמין לפני שההעברה מסתיימת.

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

  • בניית אינטגרציה שדורשת שהיסטוריה תהיה קיימת. מספרים רבים מתחברים בלעדיה.
  • ניסיון חוזר לסנכרן אחרי 2593107. זה אירוע חד-פעמי, ולכן הניסיון מחזיר את אותה שגיאה.
  • דחיית החלטת ההיסטוריה עד תחילת עבודת האינטגרציה, שבדרך כלל מתרחשת אחרי שחלפו 24 השעות.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

כמה היסטוריה מגיעה?

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

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

לא. קבוצות מוחרגות לחלוטין מה-API במספר Coexistence.

אפשר לבקש זאת שוב מאוחר יותר?

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

מה קורה אם הבעלים דחה את שיתוף ההיסטוריה?

לא מגיע דבר בשדה הזה, וה-API רואה רק הודעות מרגע חיבור המספר.

המשיכו לקרוא

The smb_app_state_sync webhookContact synchronisation from the WhatsApp Business app arrives on this field. What it carries and why it is separate from message history.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.What syncs to the API, and what does notContacts and one-to-one history cross over. Groups, catalog, labels, quick replies and away messages do not. The complete list, in one place.WhatsApp error 2593108: sync outside the 24 hour windowError 2593108 means the contact and history sync was started more than 24 hours after onboarding. The window is fixed and re-onboarding is the only reset.

מוכנים להתחיל?

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

התחילו תקופת ניסיון בחינם

נבדק ב-

היסטוריית וובהוק (Webhook)