וובהוק ההודעות (Webhook)
messages הוא השדה שמעביר כל מה שלקוח שולח למספר שלכם: טקסט, מדיה, תשובות, תגובות ותשובות אינטראקטיביות. במספר Coexistence מנותב הוא עובר מ-Meta ישירות לנקודת הקצה שלכם, ולא דרך ספק.
שדה הוובהוק שמעביר הודעות נכנסות של לקוחות.
הקידומת של מזהה ההודעה, המשמשת למניעת עיבוד כפול של ניסיונות חוזרים.
הסטטוס ש-Meta מצפה לקבל במהירות, לפני עיבוד כלשהו.
מה ה-payload כולל
מסר אחד או יותר במשלוח יחיד, ובכל אחד השולח, מזהה וסוג. הסוג קובע אילו מפתחות נוספים יופיעו.
- מספר הטלפון של השולח ומזהה הטלפון של המספר שאליו נשלחה ההודעה.
- מזהה הודעה מסוג wamid, שעליו מבוססת מניעת השליחה הכפולה.
- חותמת זמן של Unix.
- סוג: text, image, audio, video, document, sticker, location, contacts, reaction, button או interactive.
- בסוגי מדיה, מזהה מדיה לשליפה, ולא הבתים עצמם.
למה הוא לא מגיע אלינו במספר מנותב
כי override מעביר את השדה הזה, יחד עם smb_message_echoes, לכל יעד שתבחרו.
Meta מאפשרת לאפליקציה לשנות את היעד שאליו חשבון WhatsApp Business שולח וובהוקים. אנחנו מגדירים את השינוי לכתובת ה-URL שלכם, וכך מסלול ההודעה יוצא לחלוטין מהתשתית שלנו. אין אצלנו עותק, תור או שמירה, כי המשלוח כלל לא מגיע לשם.
כשלא מוגדר יעד, האירועים האלה חוזרים לכתובת ההחזרה המוגדרת כברירת מחדל, והמטפל משליך אותם בלי לשמור. זה ההבדל בין טענה על אחסון לבין מסלול קוד: אין מקום שאליו תוכן השיחה יכול להגיע.
איך מאשרים קבלה נכון
החזירו 200 לפני שאתם מתחילים לעבוד, לא אחר כך.
Meta מתייחסת לתגובה איטית כאל שגיאה ומנסה שוב, ולכן מטפל שמעבד את הבקשה בתוך התהליך עלול לראות את אותה הודעה יותר מפעם אחת. השיבו מיד, העבירו את ה-payload לתור או למשימת רקע, ותנו לעיבוד להתבצע מחוץ לבקשה.
בסביבה ללא שרת זה חובה. פונקציה שמחזירה תגובה וממשיכה לעבוד עלולה להיעצר ברגע שהתגובה נשלחת, לכן אישור הקבלה והעיבוד חייבים להיות נפרדים באמת.
מניעת עיבוד כפול
תמיד לפי wamid, כי ניסיונות חוזרים הם חלק רגיל מהמערכת ולא מצב חריג.
אותה הודעה יכולה להגיע פעמיים מסיבות שאינן קשורות לבאג אצלכם: תגובה איטית, פקיעת זמן ברשת או פריסה שהתרחשה באמצע המשלוח. שמירת מזהים שכבר נראו ודילוג על כפילויות דורשים כמה שורות, והם ההבדל בין מענה יחיד ללקוח לבין שניים.
במספר Coexistence זה חשוב במיוחד, כי smb_message_echoes מגיע באותו מסלול. מטפל שמתייחס לכל אירוע כחדש עלול להשיב בזמן שאיש צוות כבר ענה ללקוח.
טעויות נפוצות
- מעבדים לפני שמחזירים 200. Meta מנסה שוב אחרי תגובה איטית, ואתם מטפלים בהודעה פעמיים.
- מדלגים על מניעת עיבוד כפול. ניסיונות חוזרים הם חלק מתכנון המערכת, לא מקרה קצה.
- מצפים לקבל בתים של מדיה בתוך ה-payload. הוא כולל מזהה מדיה שאיתו שולפים אותה.
EasyCoexistence מנתבת את השדה הזה ישירות מ-Meta לנקודת הקצה שלכם ושומרת רק את האירועים התפעוליים הנדרשים לניטור, כך שלתוכן השיחה אין מסלול לאחסון שלנו.
שאלות נפוצות
האם EasyCoexistence רואה את הודעות הלקוחות שלי?
לא. השינוי מעביר את השדה הזה לנקודת הקצה שלכם. כל דבר שמגיע לכתובת ההחזרה שלנו מושלך בלי להישמר.
האם כמה הודעות יכולות להגיע בבקשה אחת?
כן. משלוח יחיד יכול להכיל יותר מהודעה אחת, לכן המטפלים צריכים לעבור על כולן ולא לקרוא רק את הראשונה.
איך מקבלים את המדיה?
ה-payload כולל מזהה מדיה. שולפים באמצעותו את הכתובת עם אסימון הגישה של המספר, ואז מורידים את הקובץ.
מהו smb_message_echoes?
זהו שדה נלווה שמעביר את מה שהצוות שלכם שולח מאפליקציית WhatsApp Business. הוא קיים רק במספרי Coexistence.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-