Your AI Connector Docs

חבר אפליקציית Meta משלך

הפעל את WhatsApp דרך אפליקציית Meta משלך ושלם ל-Meta ישירות לפי התעריפים שלהם. Your AI Connector אינה מוסיפה עמלות לכל הודעה בחיבור זה, ואין חשבון Twilio באמצע. מכיוון שחשבון ה-WhatsApp הוא שלך, הלקוחות שלך רואים תמיד רק את שם העסק שלך.

זוהי האפשרות הטכנית ביותר מבין אפשרויות החיבור ל-WhatsApp — עליך ליצור אפליקציה בתוך אתר המפתחים של Meta ולהעתיק ארבעה ערכים בחזרה לתוך Your AI Connector. תכנן כ-20 דקות לביצוע. אם זה נשמע כמו יותר ממה שאתה רוצה להתעסק איתו, החיבור המנוהל ל-WhatsApp Business נשאר הדרך הפשוטה ביותר להתחיל.

מה דרוש לך

  • גישה לחשבון ה-Meta Business Manager שלך.
  • מספר טלפון שאינו נמצא בשימוש באפליקציית WhatsApp.
  • כ-20 דקות.

חלק 1 — הגדר את האפליקציה שלך ב-Meta

בצע את השלבים האלה בצד של Meta תחילה. תאסוף ארבעה ערכים לאורך הדרך: מזהה אפליקציה (App ID), סוד אפליקציה (App secret), אסימון גישה (Access token) ו-מזהה חשבון WhatsApp (WhatsApp account ID).

1. צור אפליקציה

עבור אל developers.facebook.com, פתח את My Apps ולחץ על Create App. בחר בסוג Business ותן לה כל שם שתרצה — השם גלוי רק לך.

2. הוסף את WhatsApp לאפליקציה

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

3. הפעל את הרשאות ה-WhatsApp

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

באפליקציה שלך, פתח את App Review, ולאחר מכן את Permissions and Features. חפש את whatsapp_business_management. אם כתוב No access, לחץ על Get standard access — Meta תבקש ממך להזין מחדש את הסיסמה ותעניק את הגישה במקום. אין תקופת המתנה ואין בדיקת אפליקציה; זהו כפתור אחד בלבד.

ל-whatsapp_business_messaging יש בדרך כלל גישת Standard כבר. שתי ההרשאות צריכות להציג Standard access לפני השלב הבא, אחרת לאסימון שתייצר תחסר אחת מהן.

4. יצירת משתמש מערכת

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

5. יצירת אסימון (Token) עבור אותו משתמש

בחרו את משתמש המערכת ולחצו על Generate token (יצירת אסימון). בחרו את האפליקציה שלכם, בחרו אסימון שלעולם לא יפוג, וסמנו את שתי ההרשאות: whatsapp_business_messaging ו-whatsapp_business_management. Meta מציגה את האסימון פעם אחת בלבד — העתיקו אותו מיד.

6. מציאת מזהה חשבון ה-WhatsApp שלכם

בהגדרות עסקיות, פתחו את חשבונות, לאחר מכן את חשבונות WhatsApp, ובחרו את החשבון שלכם. המספר הארוך שמופיע מתחת לשם החשבון הוא המזהה (ID).

ה-App ID (מזהה האפליקציה) וה-App secret (סוד האפליקציה) שלכם נמצאים בתוך הגדרות האפליקציה של האפליקציה, תחת Basic (בסיסי). לחצו על Show (הצג) לצד ה-App secret כדי לחשוף אותו.

חלק 2 — חיבור ב-Your AI Connector

פתח את הגדרות (Settings), לאחר מכן את ערוצים (Channels), מצא את הכרטיס WhatsApp Business API ולחץ על חבר את WhatsApp (Connect WhatsApp). בחר ב-השתמש במספר שכבר יש לך (Use a number you already have), ולאחר מכן ב-אפליקציית Meta משלך (Your own Meta app). אשף ההגדרה ייפתח עם סקירה קצרה — לחץ על התחל הגדרה (Start setup).

  1. הפרטים שלך. שלב זה חוזר על חמשת השלבים בצד של Meta מחלק 1 לצד טופס עבור ארבעת הערכים שלך. הדבק את מזהה האפליקציה (App ID), סוד האפליקציה (App secret), אסימון הגישה (Access token) ומזהה חשבון ה-WhatsApp בדיוק כפי ש-Meta מציגה אותם, ללא רווחים מיותרים, ולחץ על בדוק את הפרטים שלי (Check my details). שום דבר לא נשמר עד שהם עובדים — Your AI Connector בודקת אותם מול Meta תחילה.
  1. בחירת המספר לחיבור. האשף מציג את כל המספרים בחשבון ה-WhatsApp שלכם, כל אחד עם דירוג האיכות של Meta. בחרו את המספר שבאמצעותו סביבת עבודה זו צריכה לשלוח ולקבל הודעות ולחצו על Connect this number (חבר מספר זה).
  1. הפעלה ומסירה. Your AI Connector מפעיל את המספר עבור ה-Cloud API ורושם את ה-webhook שלו ב-Meta באופן אוטומטי, כך שהודעות נכנסות יגיעו לתיבת הדואר הנכנס שלך — ברוב המקרים תגיע ישירות לכרטיס החיבור עם אישור “Number connected” (מספר מחובר). אם השלב האוטומטי לא מצליח להסתיים, האשף יציג את ה-callback URL ואת ה-verify token עם לחצני העתקה וידריך אותך כיצד להוסיף אותם ב-Meta בעצמך; אותם ערכים יישארו גלויים בכרטיס החיבור למקרה ש-Meta תבקש ממך להזין אותם שוב.
  2. האשף בודק את החיבור בעצמו. בשלב האחרון הוא מאמת את ההגדרה באופן אוטומטי — ללא צורך בהמתנה מצדך. ברגע שהכרטיס מציג סטטוס מחובר, שלח לעצמך הודעת WhatsApp מטלפון אחר וראה אותה מגיעה לצ’אטים שלך: שיחות במספר זה יזרמו כעת כמו בכל ערוץ אחר, וסוכני ה-AI שלך יוכלו להשיב בהן. אם הבדיקה מוצאת משהו ש-Meta עדיין דורשת (למשל אימות של המספר), הכרטיס יציין בדיוק מהו, והלחצן Verify connection (אימות חיבור) יריץ את הבדיקה שוב ברגע שתתקן זאת.

ניתן לחזור לאותו עמוד בכל עת כדי לבדוק את סטטוס החיבור, להתחבר מחדש (Reconnect) עם פרטים רעננים, או ללחוץ על ניתוק (Disconnect) — המספר שלך, חשבון ה-Meta שלך והחיובים שלך נשארים בבעלותך.

מעבר מחיבור מנוהל

באפשרותך להתחיל עם חיבור WhatsApp Business מנוהל ולעבור לאפליקציית Meta משלך במועד מאוחר יותר. שניהם קיימים באותו חשבון, כך שאין צורך לבנות דבר מחדש.

  • אנשי הקשר והיסטוריית הצ’אטים שלך נשמרים. אנשי קשר, שיחות, תגיות, סוכנים ומאגר הידע שייכים לחשבון שלך, לא לחיבור. הסרה או החלפה של מספר אינה מוחקת דבר מכל אלו, וכאשר מישהו שכתב לך בעבר שולח הודעה למספר שוב, היא מגיעה לאותה שיחה.
  • המספר חייב לעבור קודם בצד של Meta. WhatsApp מאפשרת למספר להיות במקום אחד בכל פעם. בקש מהתמיכה לשחרר את המספר מההגדרה המנוהלת, הוסף אותו לחשבון ה-WhatsApp Business שלך ב-WhatsApp Manager, ולאחר מכן בצע את השלבים בדף זה. צפה לכך שהמספר יהיה לא זמין לזמן קצר במהלך המעבר.
  • השתמש במספר שבבעלותך אם בכוונתך לעבור. מספר שנשכר בתוך Your AI Connector הוא קו וירטואלי השייך להגדרה המנוהלת ולא ניתן פשוט להעביר אותו לאפליקציית Meta משלך, לכן מעבר משמעו מספר WhatsApp חדש.
  • יש לאשר תבניות מחדש. Meta מאשרת תבניות עבור כל חשבון WhatsApp Business, לכן עליך ליצור מחדש את התבניות שבהן אתה משתמש תחת החשבון שלך (ראה תבניות להלן).
  • סוכנויות: כל תת-חשבון מתחבר לאפליקציית Meta משלו, כך שלקוחות יכולים לעבור אחד בכל פעם.

כדאי לדעת

  • חלון ה-24 שעות תקף, כפי שקורה בכל חיבור WhatsApp Business. תמיד ניתן להשיב בחופשיות לאנשים ששלחו לך הודעה ב-24 השעות האחרונות. מחוץ לחלון זה, WhatsApp מאפשרת לעסקים להתחיל שיחות רק באמצעות תבנית הודעה מאושרת — הודעת טקסט רגילה תתקבל על ידי Meta אך לא תימסר.
  • Meta מחייבת אותך ישירות עבור שיחות לפי התעריפים המפורסמים שלהם לכל מדינה, באמצעות אמצעי התשלום המקושר לחשבון ה-WhatsApp שלך ב-Meta. Your AI Connector אינה גובה תשלום עבור הודעה בחיבור זה; השימוש ב-AI מחויב בקרדיטים כרגיל.
  • שמור על אמצעי תשלום תקף בחשבון ה-WhatsApp ההוא. ללא אמצעי תשלום, Meta חוסמת כל שיחה שהעסק שלך מתחיל — שידורים וכל הודעת תבנית — ומציגה את השגיאה ב-WhatsApp Manager. בחיבור זה, שידור יסרב להתחיל במצב כזה, וינחה אותך להוסיף אמצעי תשלום במקום להיכשל הודעה אחר הודעה. תשובות לאנשים ששלחו לך הודעה תחילה עדיין נשלחות לעת עתה, אך החל מ-1 באוקטובר 2026 Meta תחייב גם עליהן, כך שחשבון ללא אמצעי תשלום פעיל יושתק לחלוטין בתאריך זה. התמונה המלאה נמצאת ב-עלויות WhatsApp והשינוי של אוקטובר 2026.
  • הערכת העלויות שלך נראית כאן אחרת. מכיוון שעמלות אלו לעולם אינן נוגעות בקרדיטים שלך, ההערכה בשלב הבדיקה של שידור מציגה את מספר אנשי הקשר וחלוקת המדינות עם הערה ש-Meta מחייבת אותם בחשבון ה-WhatsApp Business שלך, במקום סך קרדיטים.
  • מספרי בדיקה הם בחינם. מספר הבדיקה ש-Meta נותנת לכל אפליקציה חדשה יכול לשלוח הודעות לעד חמישה נמענים מאומתים ללא עלות — דרך נוחה לנסות את ההגדרה המלאה לפני שמפנים אליה מספר אמיתי.

תבניות

תבניות הודעה פועלות בחיבור זה, והן נמצאות בחשבון ה-WhatsApp Business שלך. צור תבנית בדף תבניות (Templates), והיא תיווצר בחשבון זה ותיבדק על ידי Meta, כאשר התוצאה (מאושרת, ממתינה או נדחתה) תוצג לך כאן. תבניות שכבר יש לך ב-WhatsApp Manager יופיעו ברשימה באופן אוטומטי, וכפתור סנכרון מ-Meta (Sync from Meta) ימשוך כל שינוי שביצעת שם. השליחה פועלת בדיוק כפי שהיא פועלת בכל חיבור WhatsApp אחר — בחר תבנית מאושרת כדי להתחיל שיחה או לפתוח אותה מחדש מחוץ לחלון 24 השעות. הפרטים המלאים נמצאים ב-שימוש בתבניות עם חשבון ה-WhatsApp של Meta שבבעלותך.

אם משהו לא עובד

  • “לא הצלחנו להתחבר עם הפרטים האלה” — העתק מחדש כל ערך; רווח מיותר הוא בדרך כלל הגורם לכך. ההודעה כוללת את התגובה של Meta עצמה, שבדרך כלל מציינת איזה ערך שגוי.
  • השגיאה אומרת שהאסימון (token) חסר whatsapp_business_management — לאפליקציה שלך עדיין לא ניתנה הרשאה זו. חזור לחלק 1, שלב 3, לחץ על קבל גישה סטנדרטית (Get standard access), ולאחר מכן צור אסימון חדש כששתי ההרשאות מסומנות ובדוק שוב את הפרטים שלך. יצירה מחדש של האסימון ללא ביצוע שלב זה תמשיך להניב את אותה שגיאה.
  • האסימון שלך נעלם — Meta מציגה אסימון פעם אחת בלבד. צור אסימון חדש מאותו משתמש מערכת; הישן ימשיך לעבוד עד שתבטל אותו, אך רק החדש יהיה גלוי.
  • תגובות נכשלות עם “שיחה זו הגיעה למספר WhatsApp Business …, שאינו המספר המחובר” — לאפליקציית ה-Meta שלך יש יותר ממספר אחד, ואנשים שולחים הודעות למספר שאינו המספר המחובר כאן. ההודעות שלהם עדיין מופיעות, מכיוון ש-Meta שולחת את הודעות האפליקציה עבור כל מספר, אך ניתן להשיב רק מהמספר המחובר, ולכן ה-AI לא עונה להן. כרטיס ה-WhatsApp בדף ערוצים (Channels) מציג אזהרה המציינת את המספר הזה בזמן שהודעותיו ממשיכות להגיע. בשורה של המספר בכרטיס זה אין לחצן ‘התחבר מחדש’ (רק הגדר כראשי ומחיקה): פתח שוב את דף החיבור לאפליקציית Meta שלך (חבר WhatsApp בכרטיס WhatsApp Business API, לאחר מכן השתמש במספר שכבר יש לך, ולאחר מכן אפליקציית Meta שלך), לחץ על התחבר מחדש בכרטיס החיבור שם ובחר את המספר שאליו הלקוחות שלך באמת כותבים. האסימון של משתמש המערכת זקוק לגישה לחשבון WhatsApp זה. אם מספר זה לא אמור להגיע ל-Your AI Connector כלל, הסר אותו (או את חשבון ה-WhatsApp שלו) מאפליקציית ה-Meta שלך במקום זאת.
  • הודעות שאתה מתחיל אינן מגיעות — בדוק את ההערה לגבי חלון 24 השעות לעיל: מחוץ לחלון זה, רק הודעות תבנית נמסרות.
  • שום דבר לא מגיע — המספר כנראה עדיין לא הופעל עבור ה-Cloud API. מספר יכול להיות פעיל במקום אחד בלבד בכל פעם, לכן אם הוא עדיין מחובר לאפליקציית WhatsApp Business בטלפון, הסר אותו משם תחילה, ולאחר מכן לחץ על אמת חיבור (Verify connection) בכרטיס החיבור. Your AI Connector מפעיל אותו עבורך ומודיע לך במקום אם ל-Meta עדיין חסר משהו.
  • “למספר זה כבר יש קוד אימות דו-שלבי” — המספר הוגדר במקום כלשהו בעבר ושמר את הקוד שלו. כבה את האימות הדו-שלבי עבורו ב-WhatsApp Manager, ולאחר מכן לחץ על התחבר מחדש.
  • “Meta עדיין לא אימתה מספר זה” — השלם את אימות המספר ב-WhatsApp Manager (Meta שולחת לו קוד), ולאחר מכן לחץ על התחבר מחדש.
  • “מספר זה מאוחסן ב-On-Premises API” — הוא פועל על המוצר הישן יותר של WhatsApp המאוחסן עצמית, שלא יכול לשתף מספר עם ה-Cloud API. העבר אותו ל-Cloud API ב-WhatsApp Manager תחילה.