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

"Your app is missing required Graph API permissions for Cloud API companion pairing"

ההודעה הזו אומרת שלפלטפורמה שהפעילה את ההרשמה חסרות הרשאות WhatsApp ש-Meta דורשת, ברמת הגישה ש-Meta דורשת, כדי שמספר מאפליקציית WhatsApp Business יתחבר ל-Cloud API בהצלחה. Meta מאפשרת לעסק להעניק רק הרשאות שלפלטפורמה יש עליהן גישה מתקדמת (Advanced access). העסק לא יכול לתקן את זה, הפלטפורמה צריכה.

Advanced access

מה שותף צריך לכל הרשאה, לפני שהלקוחות שלו יוכלו להעניק אותה דרך תהליך Embedded Signup.

200

השגיאה שקריאות ל-API מחזירות כשמשתמשים בהרשאה whatsapp_business_management ללא גישה מתקדמת, בחשבונות שהאפליקציה לא מחזיקה בהם.

2 permissions

ההרשאות whatsapp_business_management, whatsapp_business_messaging: שתיים ש-Meta אומרת שאינטגרציות WhatsApp זקוקות להן בדרך כלל.

Tech Provider

Meta דורשת שהפלטפורמה כבר תהיה Solution Partner או Tech Provider לפני שתצרף משתמשים של אפליקציית העסקים.

מה ההודעה אומרת?

הנוסח המלא: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." ההפניות הציבוריות של Meta לשגיאות לא מפרטות את הנוסח המדויק הזה, אבל כל חלק בו מתאים למשהו ש-Meta כן מתעדת.

"Your app" היא אפליקציית Meta של הפלטפורמה שמפעילה את ההרשמה, לא אפליקציית WhatsApp Business בטלפון. Meta לא מגדירה בפומבי מהו companion pairing. לפי ההקשר, הכוונה לכך ש-Cloud API מצטרף למספר שנשאר רשום באפליקציית WhatsApp Business, וזה בדיוק מנגנון Coexistence. המילה "advanced" מתייחסת לגישה מתקדמת (Advanced access), הרמה ש-Meta מעניקה אחרי סקירה.

אילו הרשאות מעורבות?

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

אצל שותף שהלקוחות שלו משתמשים באפליקציה שלו, Meta דורשת App Review וגישה מתקדמת לכל הרשאה שהאפליקציה צריכה. Meta מציינת את התוצאה במפורש: בלי גישה מתקדמת להרשאה, הלקוחות לא יכולים להעניק אותה לאפליקציה דרך Embedded Signup. קריאות עם whatsapp_business_management בחשבונות שהאפליקציה לא מחזיקה בהם, ללא גישה מתקדמת, מחזירות שגיאה 200.

פלטפורמה יכולה לבדוק מה העסק העניק בפועל: שולחים את אסימון הגישה (Access Token) לנקודת הקצה debug_token של Meta, ובתגובה, תחת scopes, מופיעות ההרשאות שהוענקו.

מה העסק יכול לעשות?

מעט מאוד מצדו, ואין לנסות לשנות את הגדרות Meta שלו כדי לפתור את זה. התיקון אצל הפלטפורמה: היא צריכה להיות Tech Provider או Solution Partner, דרישה ש-Meta מציינת לצירוף משתמשי אפליקציית WhatsApp Business, וגם לקבל אישור לגישה מתקדמת להרשאות WhatsApp.

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

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

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

EasyCoexistence היא Meta Tech Provider עצמאית עם אפליקציית Meta משלה, ומפעילה Embedded Signup v4 עבור Coexistence, כך שעסקים מחברים את המספר דרך פלטפורמה שכבר מחזיקה בגישה ש-Meta דורשת.

שאלות נפוצות

האם יש בעיה באפליקציית WhatsApp Business שלי?

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

האם אפשר להעניק את ההרשאה בעצמי?

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

איך פלטפורמה מקבלת גישה מתקדמת?

דרך Meta App Review, לכל הרשאה שהאפליקציה שלה צריכה, כשותפה שהלקוחות שלה משתמשים באפליקציה.

האם App Review נדרש גם מהעסק?

לא. לפי Meta, מפתח שניגש רק לנתוני העסק של עצמו לא צריך לא App Review ולא גישה מתקדמת.

המשיכו לקרוא

"This authorization code has expired" after Coexistence signupWhy a platform reports that the authorization code has expired after Meta's signup popup finishes, the 30 second limit behind it, and how to complete the connection."Connect your existing WhatsApp Business app" option not showingWhy Meta's Embedded Signup does not offer to connect an existing WhatsApp Business app account, who controls that option, and what to check before retrying.Coexistence QR code scan fails in the WhatsApp Business appWhy the phone step of Coexistence signup fails when you scan the code in the WhatsApp Business app, what Meta requires on the phone, and how to retry it cleanly.What being a Meta Tech Provider means, and why it mattersA Tech Provider connects other businesses' WhatsApp numbers through its own Meta app. What the status requires, and what it changes for the client.Meta Business Portfolio, and what sits inside itThe company level container in Meta Business Manager. What it holds, why it matters for a client's number, and how it differs from a WABA.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 בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

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

נבדק ב-

שגיאת Coexistence: חסרות הרשאות Graph API