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

שגיאת WhatsApp 3: בעיית יכולת או הרשאות

קוד שגיאה 3 אומר שלאפליקציה שקוראת לנקודת הקצה חסרה יכולת או הרשאה שנקודת הקצה דורשת. התיאור של Meta הוא "Capability or permissions issue." ב-Graph API הקוד נקרא API Method. הפתרון: בודקים את ההרשאות שהוענקו לאסימון באמצעות כלי הניפוי של אסימוני גישה (Access Token Debugger) ומוסיפים את ההרשאה שנקודת הקצה צריכה.

3

הקוד של Meta עבור "Capability or permissions issue."

API Method

השם שהמדריך לטיפול בשגיאות ב-Graph API נותן לקוד 3.

2 permissions

שתי ההרשאות שרוב נקודות הקצה של WhatsApp דורשות: whatsapp_business_management, whatsapp_business_messaging

מה המשמעות של קוד שגיאה 3 ב-WhatsApp?

המשמעות היא שהבקשה אומתה, אבל האפליקציה לא מורשית לבצע את מה שביקשה.

Meta מונה את קוד 3 בין שגיאות ההרשאה במדריך העזר של Cloud API, עם טקסט הפרטים "Capability or permissions issue." המדריך לטיפול בשגיאות ב-Graph API, שממנו Cloud API יורש, קורא לאותו קוד API Method ומורה לוודא שלאפליקציה יש את היכולת או ההרשאות הנדרשות לקריאה.

כלומר האסימון עובד. הזהות אינה הבעיה, וזה מה שמבדיל את השגיאה מקודים 0 ו-190. הבעיה היא למה האסימון רשאי לגשת.

איך בודקים אילו הרשאות יש לאסימון?

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

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

ב-WhatsApp שתי הרשאות מכסות כמעט הכול. ההרשאה whatsapp_business_management נדרשת למטא-דאטה של החשבון, לתבניות, לרשימות מספרים, לנתוני אנליטיקה ולוובהוקים של החשבון. ההרשאה whatsapp_business_messaging נדרשת לשליחת כל הודעה ולקבלת וובהוקים של הודעות וסטטוס. אסימון שמחזיק רק באחת מהן ייכשל בקריאות שדורשות את השנייה.

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

כי לשותפים שמשרתים עסקים אחרים יש שער נוסף.

המדריך להרשאות של Meta קובע ששותף שהלקוחות שלו ניגשים לנתונים שלהם דרך האפליקציה שלו חייב לעבור App Review ולהחזיק בגישה מתקדמת (Advanced access) לכל הרשאה שהאפליקציה צריכה. מפתח שעובד רק עם נתוני העסק שלו לא צריך App Review או גישה מתקדמת.

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

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

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

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

שאלות נפוצות

האם שגיאה 3 היא בעיה במספר הטלפון שלי?

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

מה ההבדל בין שגיאה 3 לשגיאה 10?

קוד 3 הוא בעיית יכולת או הרשאות. קוד 10 אומר שהרשאה לא הוענקה או שהוסרה. בשני המקרים הפתרון הוא לבדוק את ההרשאות של האסימון.

איזו הרשאה צריך כדי לשלוח הודעות?

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

האם ניסיון חוזר יעזור?

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

המשיכו לקרוא

WhatsApp error 10: permission not granted or removedError 10 means a permission was never granted or has been removed. How to confirm it, and the Flows and eligibility cases Meta also lists.WhatsApp error 131005: access denied, permission missingError 131005 means the permission the call needs is not granted or was removed. How to read the token's scopes and which permission sends messages.WhatsApp error 0: unable to authenticate the app userError 0 means Meta could not authenticate the app user behind the access token. The three causes Meta lists, and why a new token is the fix.WhatsApp error 200: no access token providedError 200 means no access token was sent, and the message reads 'Provide valid app ID'. It is also the start of the 200-299 permission range.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

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

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

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

נבדק ב-

שגיאת WhatsApp 3