איך מוסיפים WhatsApp ל-SaaS עם Embedded Signup ו-Coexistence
מוצר SaaS מוסיף WhatsApp על ידי חיבור המספר הקיים של כל לקוח דרך Embedded Signup עם Coexistence של Meta, כך שהמספר ממשיך לעבוד באפליקציית WhatsApp Business. עם Partner API של easyCoexistence, סשן חיבור אחד לכל לקוח מריץ את התהליך הזה בדף מתארח, Meta מעבירה את ההודעות של המספר אל כתובת webhook_url שלכם, והשרת שלכם משיב דרך ה-Cloud API עם האסימון של הלקוח.
קצב שליחה קבוע של מספר שמשמש גם באפליקציית WhatsApp Business וגם ב-Cloud API.
גרסת אפליקציית WhatsApp Business הישנה ביותר שמספר של לקוח יכול להתחבר איתה דרך Coexistence.
כמה רחוק אחורה נמשכת היסטוריית הצ'אטים ש-Meta יכולה לשתף בהטמעה; יש לסנכרן אותה תוך 24 שעות.
חלון שירות הלקוחות של WhatsApp לאחר הודעה או שיחה של משתמש; כל הודעה חדשה מאפסת אותו.
התאריך שבו Meta הוציאה משימוש את Embedded Signup גרסה 2 ו-3, והשילובים הועברו לגרסה 4.
אילו חלקים יש באינטגרציה של WhatsApp?
חמישה, ו-easyCoexistence לוקחת על עצמה את הראשון והאחרון. המוצר שלכם שומר על לוגיקת השיחה, על תיבת הדואר הנכנס ועל כל מה שהמודל שלכם או הצוות של הלקוחות כותבים, ואילו Meta מעבירה את ההודעות בין המספר לשרת שלכם:
מה 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 להעלאה; מדיה נכנסת מגיעה כמזהה שמביאים עם אותו אסימון.
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 מוסיפה 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 של כל לקוח.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-