התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

איך מוסיפים WhatsApp ל-SaaS עם Embedded Signup ו-Coexistence

מוצר SaaS מוסיף WhatsApp על ידי חיבור המספר הקיים של כל לקוח דרך Embedded Signup עם Coexistence של Meta, כך שהמספר ממשיך לעבוד באפליקציית WhatsApp Business. עם Partner API של easyCoexistence, סשן חיבור אחד לכל לקוח מריץ את התהליך הזה בדף מתארח, Meta מעבירה את ההודעות של המספר אל כתובת webhook_url שלכם, והשרת שלכם משיב דרך ה-Cloud API עם האסימון של הלקוח.

20 mps

קצב שליחה קבוע של מספר שמשמש גם באפליקציית WhatsApp Business וגם ב-Cloud API.

2.24.17

גרסת אפליקציית WhatsApp Business הישנה ביותר שמספר של לקוח יכול להתחבר איתה דרך Coexistence.

180 days

כמה רחוק אחורה נמשכת היסטוריית הצ'אטים ש-Meta יכולה לשתף בהטמעה; יש לסנכרן אותה תוך 24 שעות.

24 hours

חלון שירות הלקוחות של WhatsApp לאחר הודעה או שיחה של משתמש; כל הודעה חדשה מאפסת אותו.

October 15, 2026

התאריך שבו Meta הוציאה משימוש את Embedded Signup גרסה 2 ו-3, והשילובים הועברו לגרסה 4.

אילו חלקים יש באינטגרציה של WhatsApp?

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

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

מה Coexistence משנה עבור הלקוחות שלכם?

הם שומרים על המספר ועל הטלפון שלהם. אפליקציית WhatsApp Business ממשיכה לפעול לצד ה-Cloud API, כך שהצוות עונה מהטלפון בזמן שהמוצר שלכם עונה דרך ה-API, וכל מה שהם שולחים מהאפליקציה מגיע לוובהוק (Webhook) שלכם כאירוע מסוג smb_message_echoes. יש שלוש מגבלות: המספר שולח בקצב קבוע של 20 הודעות לשנייה, רק ה-API יכול לשלוח תבניות, ו-Meta מנתקת את המספר כשהטלפון נשאר לא פעיל כ-14 ימים בערך.

איך נראה שלב החיבור במוצר שלכם?

כפתור Connect WhatsApp שמפעיל את POST /connect-sessions מהשרת שלכם עם redirect_url, המזהה של הלקוח בשדה external_ref, וכתובת webhook_url עם webhook_verify_token, כך ש-Meta מנתבת אליכם את המספר מהדקה הראשונה. הלקוח מאשר רשימת בדיקה קצרה בדף המתארח, מפעיל את החלון הקופץ של Meta, סורק קוד QR עם אפליקציית WhatsApp Business וחוזר אליכם עם connection_id. שאלת ההרצה של Embedded Signup מאפליקציית Tech Provider משלכם נידונה במדריך המתאים.

איך ההודעות מגיעות לשרת שלכם?

מ-Meta, ישירות לכתובת webhook_url שלכם, בלי לעבור דרך easyCoexistence ובלי לשמור עותק. השדה messages נושא את מה שהלקוחות שולחים ואת הסטטוס של מה ששלחתם, ו-smb_message_echoes נושא את מה שהצוות שולח מהאפליקציה. Meta חותמת כל משלוח עם מפתח הסוד של האפליקציה של easyCoexistence, שאינו משותף לאף אחד, לכן נתיב סודי ארוך ואקראי בכתובת ה-URL מאמת אותו. שני מספרים באותו WhatsApp Business Account חולקים יעד אחד, והניתוב נעשה לפי שדה המזהה value.metadata.phone_number_id, כך שכל מספר מגיע למקומו הנכון.

איך השרת משיב ושולח תבניות?

עם Graph API של Meta ועם אסימון הלקוח שמתקבל מ-GET /connections/{id}?credentials=1, שמחזיר גם את השדה send_endpoint. טקסט חופשי נשלח בתוך 24 שעות מההודעה האחרונה של האדם; אחרי כן, רק תבנית שאושרה על ידי Meta:

  • תשובה: POST /<PHONE_NUMBER_ID>/messages עם type text, בתוך החלון הפעיל.
  • תבנית: אותה קריאה עם type template, שם התבנית וקוד השפה שלה.
  • יצירת תבנית: POST /<WABA_ID>/message_templates, ואז בדיקת הסטטוס שלה, כי תוצאות הבדיקה לא מגיעות לכתובת webhook_url שלכם.
  • מדיה: POST /<PHONE_NUMBER_ID>/media להעלאה; מדיה נכנסת מגיעה כמזהה שמביאים עם אותו אסימון.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

האם המוצר שלכם יכול לייבא את הצ'אטים הקיימים של הלקוח?

פעם אחת, בזמן החיבור. כאשר מוגדרת כתובת webhook_url בסשן, easyCoexistence מבקשת מ-Meta לשלוח את אנשי הקשר של המספר ואם הלקוח מאשר באפליקציה, עד 180 ימים של צ'אטים, שמגיעים כאירועי smb_app_state_sync ו-history. Meta מאפשרת זאת רק בתוך 24 שעות מהחיבור, לכן יש לוודא שנקודת הקצה משיבה לפני ששולחים את הקישור. המדריך להיסטוריית הצ'אטים מסביר את ה-payload של כל אחד מהם.

מי משלם ל-Meta על ההודעות?

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

מה קורה כשמספר נופל?

כתובת האירועים שלכם מקבלת connection.disconnected עם הסיבה של Meta כאשר היא ידועה. PRIMARY_INACTIVITY הוא כלל ה-14 ימים, וסשן חיבור חדש לאותו לקוח מחזיר את אותו מספר. connection.token_missing פירושו שהמספר התחבר בלי האסימון של הלקוח, לכן הוא מקבל הודעות אך לא יכול לשלוח עד שסשן חדש יחבר אותו מחדש.

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

  • שליחת קישור החיבור לפני שנקודת הקצה של הוובהוק שלכם מגיבה. ייבוא ההיסטוריה רץ פעם אחת, בתוך 24 שעות מהחיבור, ותוכן שנשלח לפני שהכתובת שלכם עובדת הולך לאיבוד.
  • מענה בטקסט חופשי אחרי שהחלון נסגר. כשעוברות 24 שעות מההודעה האחרונה של האדם, עובר רק תבנית מאושרת.
  • שליחת קמפיין מאותו מספר במלוא המהירות. מספר של Coexistence שולח בקצב של 20 הודעות לשנייה, לכן יש לתור את השליחות של כל מספר בקצב הזה.
  • לצפות שהצוות ישלח תבניות מהטלפון. ב-Coexistence רק ה-API שולח אותן, לכן יש להעביר את שליחת התבניות למוצר שלכם.
עושים את זה עם EasyCoexistence

easyCoexistence מוסיפה WhatsApp ל-SaaS שלכם עם Embedded Signup של Meta ו-Coexistence, בדף מתארח שנושא את השם שלכם. הלקוחות שומרים על המספר ועל אפליקציית WhatsApp Business, Meta מעבירה את ההודעות לשרת שלכם, והאירועים מגיעים אליכם חתומים. אותו ממשק מחבר גם את Instagram, Facebook, TikTok, YouTube, LinkedIn וערוצים נוספים. US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם לקוח יכול לחבר מספר שנמצא אצל ספק API אחר של WhatsApp?

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

האם ה-SaaS שלי יכול לשלוח תבניות WhatsApp עבור הלקוחות שלו?

כן, דרך Cloud API עם האסימון של כל לקוח: יוצרים את התבנית בחשבון WhatsApp Business Account של הלקוח, ממתינים לאישור של Meta, ואז שולחים אותה.

האם easyCoexistence קוראת את ההודעות של הלקוחות ב-WhatsApp?

לא. Meta מעבירה את ההודעות של מספר ישירות לכתובת webhook_url שהגדרתם. מספר בלי webhook_url חוזר לקולבק של easyCoexistence, שבו ההודעות נזרקות בלי שנשמרות.

כמה עולה easyCoexistence לכל מספר WhatsApp?

US$ 9 עד US$ 0.75 למספר בחודש, לפי המדרגה של סך החיבורים שלכם, עם 3 הימים הראשונים בחינם. חיובי ההודעות של Meta הולכים לחשבון WhatsApp Business Account של כל לקוח.

המשיכו לקרוא

API מאוחד לרשתות חברתיות ל-SaaS: אינטגרציה אחת ל-WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ועוד ערוציםאינטגרציה אחת ללקוחות שלכם ב-WhatsApp, Instagram, Facebook, TikTok, YouTube ו-LinkedIn: מה מאוחד, מה כל רשת מחליטה, והקריאות.איך מוסיפים פרסום ב-TikTok ל-SaaS שלכםהוסיפו פרסום ב-TikTok ל-SaaS: חברו את חשבון TikTok של כל לקוח, פרסמו סרטונים או תמונות עכשיו או מאוחר יותר בקריאה אחת, ועקבו עד לפרסום.ממשק API רב-לקוחות לרשתות חברתיות: מפתח אחד, חשבונות רבים של לקוחותמפתח API אחד לחשבונות WhatsApp ולרשתות חברתיות של לקוחות רבים. מתייגים כל חשבון בשדה external_ref, שומרים אסימונים נפרדים ומנתבים וובהוקים לכל לקוח.Embedded Signup של WhatsApp ללקוחות שלכם: אפליקציית Tech Provider משלכם או עמוד מתארחאיך SaaS מחבר את מספרי WhatsApp של לקוחותיו עם Coexistence: מה Meta דורשת מ-Tech Provider, מה עמוד מתארח לוקח על עצמו ומה הלקוחות רואים.איך מייבאים את היסטוריית הצ'אטים ואנשי הקשר של אפליקציית WhatsApp Business דרך ה-APIייבוא אנשי קשר ועד 180 ימים של צ'אטים ממספר ב-WhatsApp Business דרך Coexistence, כולל וובהוק (Webhook) להיסטוריה ושדה chunk_order.חלון שירות הלקוחות בן 24 השעותמהו חלון שירות הלקוחות, מתי הוא נפתח ונסגר, מה מותר לשלוח בתוכו ומחוצה לו, ולמה תשובות בתוכו בחינם.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-