איך פותחים חשבון WhatsApp Business API דרך Meta Business Manager
פתיחת חשבון הודעות ל-WhatsApp עוברת דרך Meta Business Manager, והיא מורכבת מ-7 שלבים שצריך לעשות לפי הסדר. בסוף התהליך יש ביד ארבעה ערכים: App ID, Phone number ID, WhatsApp Business Account ID וטוקן קבוע. עם ארבעת אלה מחברים את החשבון לכל מערכת שמנהלת את ההודעות.
ההקמה עצמה לוקחת בערך שעה. מה שלוקח יותר זמן זה האימות של מטא מול האתר ומסמכי החברה, ואי אפשר לזרז אותו. לכן כדאי להכין את החומרים מראש.
מה צריך להכין לפני שמתחילים
חמישה דברים, וכדאי שכולם יהיו מוכנים לפני הצעד הראשון. חוסר באחד מהם עוצר את התהליך באמצע.
- אתר אינטרנט פעיל ב-https, פתוח לגלישה מארה"ב. באתר צריכים להופיע שם החברה, כתובת ותיאור קצר של תחום הפעילות. מטא בודקת את האתר מחוץ לישראל, ואתר שחסום לגלישה מהחוץ לא יעבור את הבדיקה, לרוב בלי הודעת שגיאה מפורטת.
- פרופיל פייסבוק אישי פעיל ובשימוש שוטף של מי שמקים את החשבון. מטא מסתכלת כאן על הפרופיל הפרטי, גם למי שיש דף עסקי.
- גישה ל-Business Manager הארגוני. אם עוד אין לכם, אפשר ליצור אחד בחינם מתוך אותו פרופיל.
- מספר טלפון ייעודי לשירות, נייד או קווי, שלא היה מותקן עליו וואטסאפ אף פעם. הוא צריך לקבל SMS או שיחה קולית בזמן ההקמה. מספר קווי שעונה עם נתב שיחות לא יעבוד, אבל אפשר להגדיר עליו עקוב אחרי.
- כרטיס אשראי להזנה בממשק. מטא גובה לפי תעבורת ההודעות מהרגע שהחשבון פעיל.
1פרטי העסק ב-Business Manager
נכנסים לפרופיל הפייסבוק שמאפשר גישה ל-Business Manager של החברה, ומשם ל-business.facebook.com/settings.
פותחים את לשונית Business Info ומוודאים שכל הפרטים מוזנים. אם השדות ריקים, ממלאים אותם עכשיו. מטא משווה בהמשך בין מה שכתוב כאן לבין מה שמופיע באתר, וכל פער מעכב את האימות.
Edit business information
✕- 1השם המלא של החברה, בדיוק כפי שהוא מופיע בתעודת ההתאגדות או בתעודת עוסק מורשה. מטא מקבלת כאן גם עברית וגם אנגלית. אם החברה רשומה בשתי הצורות, הזינו את זו שמופיעה במסמך הרשמי, ודאגו שאותה צורה מופיעה גם באתר.
- 2בוחרים Israel מהרשימה.
- 3כתובת החברה, אותה כתובת שמופיעה באתר ובדף העסקי. אם יש כמה סניפים, בוחרים אחד ונשארים איתו.
- 4מספר טלפון כפי שהוא מופיע באתר. מספרי כוכבית, 1-800 ו-1-700 לא מתקבלים כאן.
- 5כתובת האתר ב-https. מטא נותנת לשדה הזה משקל רב בבדיקת האימות, אז כדאי לוודא שהכתובת נכונה ושהאתר עולה.
- 6ח.פ. או מספר עוסק מורשה. השדה מסומן כרשות, וכדאי למלא אותו כי הוא עוזר למטא לאמת את העסק מול הרשומות הרשמיות.
2יצירת האפליקציה וחיבור ה-webhook
האפליקציה היא המעטפת שדרכה מטא נותנת גישה ל-API. יוצרים אותה פעם אחת ומשתמשים בה לאורך כל הדרך.
[שם האפליקציה]
People
Add peopleThese people have access to [שם האפליקציה]. You can view, edit or delete their permissions. Your app need at least one app admin in order to access the app dashboard and reduce the risks of missing important actions.
- 1פותחים את Accounts בתפריט הצד.
- 2לוחצים על תת הלשונית Apps.
- 3לוחצים על Add. אם הכפתור אפור ולא לחיץ, המשמעות היא שהפרופיל האישי שלכם עוד לא מאומת אצל מטא כמפתח. פותחים חשבון מפתח ב-developers.facebook.com מאותו פרופיל, וחוזרים לכאן.
- 1בוחרים Create a new app ID.
Which use case do you want to add to your app?
Get started by selecting the main use case you'd like to add to your app. You'll be asked to add permissions to your use case later.
- 1בוחרים Other. האפשרות הראשונה מיועדת להתחברות עם פייסבוק ולא רלוונטית כאן.
- 2לוחצים Next.
Select an app type
The app type can't be changed after your app is created. Learn more
- 1בוחרים Business. זה הסוג היחיד שנותן גישה ל-WhatsApp.
- 2לוחצים Next. שימו לב שאי אפשר לשנות את סוג האפליקציה אחרי היצירה.
- 1שם לאפליקציה, לבחירתכם. משהו שתזהו בעוד שנה, למשל שם החברה ואחריו WA.
- 2כתובת המייל שאליה מטא תפנה בנוגע לאפליקציה. בדקו שהיא כתובה נכון, כי התראות על חסימות מגיעות לשם.
- 3חשבון ה-Business Manager שאליו האפליקציה משויכת. אם יש לכם כמה, בחרו את זה שמילאתם בו את פרטי העסק בשלב 1.
- 4לוחצים Create app.
Instagram Graph API
Integrate your app with the Instagram API to let businesses use your app with their Instagram accounts.
Jobs
Post jobs to the Facebook platform and receive applications from users.
Marketing API
Integrate Facebook Marketing API with your app.
Messenger
Customize the way you interact with people on Messenger.
Web Payments
Accept in-app payments through Facebook's secure payment system.
ThreatExchange
Share and learn about potential threats to help everyone stay more secure.
Webhooks
Subscribe to changes and receive updates in real time without calling the API.
Integrate with WhatsApp
Facebook Login for Business
A secure way for businesses to give your app permissions to access data.
- 1גוללים למטה עד לקובייה של WhatsApp ולוחצים Set up.
- 1מוודאים שחשבון ה-Business Manager שמופיע הוא הנכון.
- 2לוחצים Continue. אם מופיעה כאן שגיאה שלא מאפשרת להתקדם, החשבון חסום להקמת שירות הודעות. פונים לתמיכה של פייסבוק דרך סימן השאלה בתחתית תפריט הצד ב-Business Manager. יש שם צ'אט בעברית, והם עונים מהר.
- curl -i -X POST `
- https://graph.facebook.com/v17.0/[phone number id]/messages `
- -H 'Authorization: Bearer [permanent access token]' `
- -H 'Content-Type: application/json' `
- -d '{ "messaging_product": "whatsapp", "to": "", "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }'
- 1לוחצים על הקישור Configure webhooks בשלב 3. הבלוק עם פקודת ה-curl שמעליו הוא הודעת בדיקה שמטא מכינה מראש, ואפשר להתעלם ממנו בשלב הזה.
Webhook
To get alerted when you receive a message or when a message's status has changed, you need to set up a Webhooks endpoint for your app. Learn how to configure Webhooks.
Permanent token
Learn how to create a permanent token
Phone numbers
You have 2 production numbers and 1 test number.
- 1לוחצים על Edit. בשלב הזה כתוב עדיין No URL added ו-No token added, כי החיבור עוד לא הוגדר.
- 2שימו לב ש-Manage מול Webhook fields אפור ולא לחיץ. הוא ייפתח רק אחרי ששומרים כתובת וטוקן, אז זו הסיבה לעשות את השלבים בסדר הזה.
- לדלג מכאן לשלב 3 ולהשלים את המדריך עד הסוף.
- להעביר לנו בסיום את חמשת הערכים שמופיעים בפרק האחרון.
בחלונית שנפתחת ממלאים שני ערכים:
Callback URL הוא הכתובת שאליה מטא תשלח כל הודעה נכנסת. ב-n8n זו כתובת ה-Production URL של צומת Webhook בתוך ה-workflow שמטפל בהודעות. מעתיקים אותה מתוך הצומת. הכתובת חייבת להיות ב-https ונגישה מהאינטרנט, אז workflow שרץ במצב Test לא יעבוד כאן.
Verify token הוא מחרוזת שאתם ממציאים. מטא שולחת אותה חזרה פעם אחת כדי לוודא שהכתובת באמת שלכם. מייצרים מחרוזת אקראית, מדביקים אותה גם כאן וגם בהגדרות הצומת ב-n8n, ושומרים עותק במקום מאובטח. חשוב שהמחרוזת תהיה ייחודית לכם. יש ברשת מדריכים שמציעים טוקן מוכן להעתקה, ועדיף לוותר על זה, כי מי שמכיר את המחרוזת יכול לרשום את עצמו כמאזין לכתובת שלכם.
לוחצים Verify and save. מטא שולחת בקשה לכתובת באותו רגע ומצפה לתשובה נכונה, אז הכתובת חייבת להיות חיה. כתובת זמנית או מקום שמור לא יעברו את הבדיקה. אם n8n לא מחזיר את התשובה הצפויה תוצג שגיאה מיד, ואז כדאי לוודא שה-workflow פעיל ושהמחרוזת זהה בשני הצדדים.
Webhook
To get alerted when you receive a message or when a message's status has changed, you need to set up a Webhooks endpoint for your app. how to configure Webhooks.
Permanent token
Learn how to create a permanent token
Phone numbers
You have 2 production numbers and 1 test number.
- 1כרגע כתוב No fields selected. מטא לא תשלח שום דבר עד שנבחר אילו אירועים מעניינים אותנו.
- 2לוחצים Manage מול Webhook fields.
Webhook fields
✕| Name | Test version | Subscription version | Subscribe 1 | |
|---|---|---|---|---|
| account_alerts | v17.0▼ | Test | v17.0▼ | ✓ |
| account_review_update | v17.0▼ | Test | v17.0▼ | ✓ |
| account_update | v17.0▼ | Test | v17.0▼ | ✓ |
| business_capability_update | v17.0▼ | Test | v17.0▼ | ✓ |
| business_status_update | v17.0▼ | Test | v17.0▼ | ✓ |
| campaign_status_update | v17.0▼ | Test | v17.0▼ | ✓ |
| message_template_quality_update | v17.0▼ | Test | v17.0▼ | ✓ |
| message_template_status_update | v17.0▼ | Test | v17.0▼ | ✓ |
| messages | v17.0▼ | Test | v17.0▼ | ✓ |
- 1מסמנים את כל תיבות הסימון בעמודת Subscribe.
Webhook fields
✕| Name | Test version | Subscription version | Subscribe | |
|---|---|---|---|---|
| messages | v17.0▼ | Test | v17.0▼ | ✓ |
| phone_number_name_update | v17.0▼ | Test | v17.0▼ | ✓ |
| phone_number_quality_update | v17.0▼ | Test | v17.0▼ | ✓ |
| security | v17.0▼ | Test | v17.0▼ | ✓ |
| template_category_update | v17.0▼ | Test | v17.0▼ | ✓ |
- 1בחלונית הזו יש שתי גלילות, אחת של הדף ואחת של הטבלה עצמה. קל לפספס את השורות התחתונות. גוללים בתוך הטבלה עד הסוף ומסמנים גם אותן.
- 2לוחצים Done.
3הגדרת מספר הטלפון
- curl -i -X POST `
- https://graph.facebook.com/v17.0/[phone number id]/messages `
- -H 'Authorization: Bearer [permanent access token]' `
- -H 'Content-Type: application/json' `
- -d '{ "messaging_product": "whatsapp", "to": "", "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }'
- 1עוברים ללשונית API Setup בתפריט הצד.
- 2לוחצים Add phone number בשלב 5.
Create a WhatsApp Business profile
This profile will show information about your business to people on WhatsApp. You can edit this information anytime by going to Business assets in Meta Business Suite Settings and selecting this WhatsApp account.
- 1שם השולח. זה השם שהלקוחות יראו בוואטסאפ, וזה השדה שהכי הרבה חשבונות נתקעים עליו. הוא צריך לייצג נאמנה את המותג ששולח את ההודעות, להופיע כטקסט חי באתר החברה, ולהופיע גם בפרטי העסק ב-Business Manager. שם כללי מדי, למשל "שירות לקוחות", בדרך כלל לא יאושר. ההנחיות המלאות של מטא.
- 2קטגוריית עסק. בוחרים מהרשימה. אם אין קטגוריה שמתאימה, בוחרים Other.
- 3תיאור העסק. שדה רשות, עד 512 תווים, וניתן לעריכה בכל שלב.
Choose how you would like to verify your number
Select how you would like to verify your number. If you are using a landline number, choose phone call.
- 1מזינים את המספר בפורמט בינלאומי ובוחרים איך לאמת אותו. למספר קווי בוחרים שיחה קולית.
- 2לוחצים Next. מטא שולחת קוד, ומזינים אותו בחלונית שנפתחת.
Temporary access token
Send and receive messages
Step 1: Select phone numbers
Send free messages with the provided test phone number. Learn more.
- curl -i -X POST `
- https://graph.facebook.com/v17.0/[phone number id]/messages `
- -H 'Authorization: Bearer [permanent access token]' `
- -H 'Content-Type: application/json' `
- -d '{ "messaging_product": "whatsapp", "to": "", "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }'
- 1App ID.
- 2Phone Number, המספר שאימתתם.
- 3Phone number ID. זה המזהה שמערכת ההודעות משתמשת בו כדי לשלוח, ולא המספר עצמו.
- 4WhatsApp Business Account ID. מעתיקים את כל הערכים האלה למקום בטוח. תצטרכו אותם בחיבור ל-n8n.
- 1משכפלים את לשונית הדפדפן ובחדשה עוברים ל-Settings.
- 2לוחצים על Basic.
- 3מאתרים את השדה App secret.
- 4לוחצים Show. מטא עשויה לבקש את סיסמת הפייסבוק שוב. מעתיקים את הערך ושומרים אותו איתם השאר.
Webhook
To get alerted when you receive a message or when a message's status has changed, you need to set up a Webhooks endpoint for your app.
Permanent token
Learn how to create a permanent token
Phone numbers
You have 2 production numbers and 1 test number.
- 1עוברים ל-Configuration בתפריט הצד.
- 2לוחצים Manage phone numbers, ואז על המספר עצמו.
במסך שנפתח מעלים תמונת פרופיל למספר, בדרך כלל הלוגו. התמונה חייבת להיות ריבועית, לפחות 640 פיקסל לכל צלע. אפשר להוסיף שם גם כתובת אתר ופרטי התקשרות.
שומרים בכפתור בפינה העליונה. את הפרטים האלה אפשר לעדכן מתי שרוצים.
4הוספת אמצעי תשלום
- curl -i -X POST `
- https://graph.facebook.com/v17.0/[phone number id]/messages `
- -H 'Authorization: Bearer [permanent access token]' `
- -H 'Content-Type: application/json' `
- -d '{ "messaging_product": "whatsapp", "to": "", "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }'
- 1לוחצים Add payment method.
- 1לוחצים Add payment method בחלק התחתון של המסך ומזינים פרטי אשראי ופרטים לחשבונית. כדאי לשים לב: ממלאים את הפרטים גם אם בחלק העליון של המסך כבר מופיעים פרטי תשלום. אלה שתי הגדרות נפרדות, וזו נקודה שקל לפספס.
אפשר להשתמש באותם פרטים שכבר מוזנים בחשבון דרך האפשרות Payment Method, או להזין כרטיס חדש דרך Credit Card. אחרי ההזנה נפתחת חלונית פרטי החשבונית.
5יצירת System User
System User הוא משתמש שאינו אדם. הוא קיים כדי להחזיק את הטוקן שהמערכת שלכם משתמשת בו. היתרון: כשעובד עוזב או מחליף סיסמה, החיבור ממשיך לעבוד.
Assigned assets
Add assetsHere are the assets n8n API User (System User) can access. View and manage their permissions. Add or remove assets.
- 1חוזרים ל-Business Manager ופותחים Users › System users.
- 2לוחצים Add.
Create system user
✕Enter a name for the system user you want to create below:
[שם חשבון ה-Business Manager] will be the owner of this system user.
- 1שם למשתמש. השם לא משפיע על התפעול, אז כדאי לבחור משהו שמסביר למה הוא משמש, למשל n8n API User.
- 2מגדירים אותו כ-Admin. אם הממשק לא מאפשר, בוחרים Employee ומתקדמים.
- 3לוחצים Create system user.
6הקצאת הרשאות ל-System User
בשלב הזה יש שלוש הקצאות נפרדות, וכדאי לעבור על כולן לפי הסדר. אם אחת מהן חסרה, הטוקן ייווצר כרגיל אבל יחזיר שגיאת הרשאות בניסיון הראשון לשלוח הודעה, וקשה לאתר את זה בדיעבד.
Add people to [שם האפליקציה]
✕Can change app settings, test the app and view analytics.
Can view app analytics.
Can test the app.
Can manage roles, change app settings, test the app and view analytics. 4
- 1פותחים Accounts בתפריט הצד.
- 2לוחצים Apps ועומדים על האפליקציה שיצרתם.
- 3לוחצים Add people ומסמנים את ה-System User.
- 4תחת Full control מעבירים את הטוגל של Manage app למצב מופעל.
- 5לוחצים Assign.
Add people to [שם חשבון הוואטסאפ]
✕You can create message templates, add phone numbers, access metrics and send messages to customers.
You can do all of the above, and also assign users and view payment information. 4
- 1פותחים שוב Accounts.
- 2לוחצים WhatsApp Accounts ועומדים על החשבון שנוצר.
- 3נכנסים ל-People, לוחצים Add people ומסמנים את אותו System User.
- 4תחת Full control מפעילים את Manage WhatsApp business accounts.
- 5לוחצים Assign.
Assign Assets to n8n API User
✕Can change app settings and view analytics.
Can view app analytics.
Can test the app.
Can manage roles, change app settings and view analytics. 4
- 1פותחים Users › System users ועומדים על המשתמש.
- 2לוחצים Add Assets ובוחרים Apps.
- 3מסמנים את האפליקציה שיצרתם.
- 4תחת Full control מפעילים את Manage app.
- 5לוחצים Save changes.
7הפקת הטוקן הקבוע
- 1לוחצים Generate new token.
Generate token
✕- 1בוחרים את האפליקציה שיצרתם.
- 2מסמנים Permanent. האפשרות של 60 ימים מתאימה לבדיקות. בחשבון שעובד בפועל, טוקן שפג תוקפו מנתק את החיבור בלי התראה מראש.
By clicking 'Generate token', you agree to install selected app for system user API User.
- 1מסמנים את whatsapp_business_messaging.
- 2מסמנים את whatsapp_business_management. אלה שתי ההרשאות שצריך. השאר יכולות להישאר כבויות.
- 3לוחצים Generate token.
Generate token
✕******************************
******************************
****************
Copy and save this token as it won't be stored at Facebook.
- 1מעתיקים את הטוקן לפני שסוגרים את החלון. מטא לא שומרת אותו, ואין דרך להציג אותו שוב מאוחר יותר. אם החלון נסגר לפני שהספקתם, אפשר לייצר טוקן חדש ולחזור על השלב.
מה יהיה לכם בסוף התהליך
בסוף ההקמה יהיו לכם חמישה ערכים. אלה פרטי החיבור של חשבון ההודעות, וכל מערכת שתנהל את הוואטסאפ תבקש אותם:
- WhatsApp Business Account ID, המזהה של חשבון הוואטסאפ העסקי
- Phone Number ID, המזהה של המספר שאימתתם
- App Secret, המפתח הסודי של האפליקציה
- App ID, המזהה של האפליקציה שיצרתם
- הטוקן הקבוע, שמאפשר למערכת להתחבר בשם החשבון
מומלץ לשמור את כולם במקום מאובטח, למשל במנהל סיסמאות ארגוני. בפועל קורה שהפרטים מגיעים בהתחלה בקובץ אקסל או במייל, וזה בסדר כשלב ביניים. כדאי להעביר אותם משם ברגע שההקמה מסתיימת.
שווה לשים לב לטוקן הקבוע במיוחד: הוא מאפשר לשלוח הודעות בשם העסק, והוא נשאר בתוקף עד שמבטלים אותו ידנית מהממשק. לכן נוח לתת גישה אליו רק למי שבאמת עובד מול החיבור.
אם דילגתם על הווב-הוק בשלב 2 כי אנחנו מקימים לכם את האוטומציה, החשבון תקין ומוכן והעבודה שלכם נגמרה כאן. חמשת הערכים שלמעלה זה כל מה שאנחנו צריכים כדי לחבר את המערכת.
השלב הבא הוא תבניות ההודעות. כל הודעה שהעסק יוזם צריכה אישור מראש של מטא, וזה תהליך נפרד עם כללים משלו. נרחיב עליו במדריך נפרד.
כל צילומי המסך במדריך הזה נבנו מחדש ב-HTML. הם מציגים את מבנה המסכים של מטא עם פרטים מוסתרים, כדי שלא יופיעו כאן שמות חשבונות או מזהים של אף אחד.