דלג לתוכן הראשי

​
הגדרת Meta Embedded Signup

​
סקירה כללית

המטרה היא להגדיר את Meta App Dashboard, את flow ה-OAuth ואת משתני הסביבה כך שזרימת WhatsApp Embedded Signup תפעל בצורה תקינה עבור חיבור ערוצי WhatsApp. כרגע הקוד משתמש ב:
  • META_APP_ID
  • META_APP_SECRET
  • NEXT_PUBLIC_META_APP_ID
  • NEXT_PUBLIC_META_WA_CONFIG_ID

​
1. דרישות מוקדמות

  • חשבון Meta Developer
  • חשבון Facebook Business
  • Meta App מסוג Business
  • גישת אדמין לסביבות הפריסה

​
2. יצירת או בחירת Meta App

  1. עברו ל-developers.facebook.com
  2. צרו App מסוג Business או בחרו קיימת
  3. תחת Settings > Basic העתיקו:
ערךשימוש
App IDעבור META_APP_ID וגם NEXT_PUBLIC_META_APP_ID
App Secretעבור META_APP_SECRET בלבד

​
3. הוספת מוצר WhatsApp

  1. ב-Meta App Dashboard הוסיפו את מוצר WhatsApp
  2. ודאו שה-App במצב שמאפשר לכם לבדוק את הזרימה

​
4. הגדרת Webhook URL ו-Verify Token

ה-webhook של Agentix הוא: 
https://{your-api-domain}/webhooks/whatsapp
שימו לב:
  • webhookVerifyToken נשמר פר-channel ונוצר אוטומטית בזמן החיבור
  • אפשר להשלים קודם Embedded Signup, ואז לחזור להזין את ה-token הנכון ב-Meta
בנוסף:
  1. הגדירו את ה-callback URL ב-Meta
  2. הירשמו לשדה messages

​
5. יצירת Facebook Login for Business Configuration

  1. פתחו Facebook Login for Business
  2. עברו אל Configurations
  3. צרו configuration עם:
שדהערך
Login variationWhatsApp Embedded Signup
Token typeSystem-user access token
AssetsWhatsApp accounts
Permissionswhatsapp_business_management
  1. העתיקו את Config ID ל-NEXT_PUBLIC_META_WA_CONFIG_ID
Config ID הוא לא App ID. שימוש בערך הלא נכון יגרום לפתיחת Facebook Login רגיל במקום זרימת WhatsApp Embedded Signup.

​
6. הגדרת OAuth Redirect URIs ו-Allowed Domains

ב-Facebook Login for Business > Settings:
שדהערך
Valid OAuth Redirect URIshttps://{your-frontend-domain}
Allowed Domains for the JavaScript SDKhttps://{your-frontend-domain}
דרישות:
  • חובה HTTPS
  • אין wildcards
  • הדומיין חייב להתאים בדיוק לדומיין ה-frontend

​
7. הגדרת משתני סביבה

משתנהיישוםמקור
META_APP_IDAPISettings > Basic > App ID
META_APP_SECRETAPISettings > Basic > App Secret
NEXT_PUBLIC_META_APP_IDWebאותו App ID
NEXT_PUBLIC_META_WA_CONFIG_IDWebFacebook Login for Business > Configurations
META_APP_ID ו-NEXT_PUBLIC_META_APP_ID חייבים להיות זהים. אם לא, החלפת ה-code לטוקן תיכשל.

​
8. Checklist לאימות

  • ה-App מסוג Business
  • מוצר WhatsApp נוסף
  • webhook URL מוגדר
  • נרשמתם לשדה messages
  • נוצר Facebook Login for Business configuration
  • Config ID הוגדר נכון
  • OAuth redirect URI נכון
  • כל משתני הסביבה הוגדרו

​
9. פתרון תקלות

בעיהכיוון בדיקה
נפתח login רגיל של FacebookNEXT_PUBLIC_META_WA_CONFIG_ID שגוי
token exchange נכשלMETA_APP_ID ו-NEXT_PUBLIC_META_APP_ID לא תואמים
webhook verification נכשלverify token שגוי או channel לא נוצר עדיין
popup לא נטעןדומיין לא מורשה או redirect URI שגוי