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

הוובהוק (Webhook) phone_number_quality_update

phone_number_quality_update מדווח על שינויים בקצב השליחה ובמגבלת ההודעות של מספר. נכון ל-2026, הוא לא כולל את דירוג האיכות הירוק, הצהוב או האדום, למרות שמו. את הדירוג קוראים ישירות מהמספר.

2026

השנה שבה תוכן השדה השתנה ולא כלל עוד את דירוג הצבע.

3

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

131048

השגיאה שמספר מחזיר לאחר שהגבלת האיכות נכנסת לתוקף.

מה הוובהוק (Webhook) הזה באמת כולל?

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

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

מה שלא נמצא בו, למרות שם השדה, הוא דירוג האיכות. מטפל שנכתב לפי תיעוד ישן יחפש כאן GREEN, YELLOW או RED, לא ימצא דבר ויסיק שהאיכות לא משתנה.

מאיפה מגיע דירוג הצבע, אם כך?

קוראים אותו ישירות מהמספר, לפי לוח זמנים.

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

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

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

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

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

שאלות נפוצות

למה השדה נקרא על שם האיכות?

הוא נוצר לפני השינוי. השם נשאר, אבל התוכן השתנה, ולכן הוא מבלבל אנשים.

באיזו תדירות צריך לדגום את הדירוג?

בתדירות שמאפשרת לזהות ירידה לפני שהיא הופכת להגבלה. אנחנו דוגמים לפי לוח זמנים ולא לפי דרישה.

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

לא. שום דבר לגבי הדירוג לא מופיע באפליקציית WhatsApp Business בטלפון.

האם 131048 קשורה לכך?

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

המשיכו לקרוא

The phone_number_name_update webhookMeta reports display name approvals and rejections here. It is the only place the decision appears, and nothing shows it in the app.The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.WhatsApp error 131048: spam rate limit hitError 131048 means the number's quality has dropped far enough that Meta is limiting sends. What causes the drop and how a number recovers.A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.

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

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

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

נבדק ב-

phone_number_quality_update