Shipnest

חיפוש בתיעוד

חפשו לפי נושא, endpoint, או מונח

אינטגרציות

WhatsApp Business

חיבור חשבון ה-WhatsApp Business שלכם דרך Meta Cloud API הרשמי — לשליחת התראות משלוח, קבלת תגובות לקוחות, והפעלת הבוט. כאן: מה צריך מ-Meta, איך מאמתים webhook, וכללי המשחק של תבניות וחלון 24 השעות.

עודכן: 23 ביוני 2026

סקירה

מה החיבור עושה

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

הגדרה

פרטי החיבור

נכנסים ל-הגדרות → אינטגרציות → Meta Cloud API ומזינים מ-Meta Business → WhatsApp → API Setup:

  • Access Token — טוקן הגישה (EAAB…), מאוחסן מוצפן.
  • Phone Number ID — מזהה מספר הטלפון של החברה.
  • WhatsApp Business Account ID (WABA) — נחוץ לסנכרון תבניות ולמנוי webhook.
  • App Secret — מ-Meta App → Settings → Basic, לאימות חתימת ה-webhooks (מוצפן).
  • Verify Token — מחרוזת שאתם בוחרים, מוזנת גם כאן וגם ב-Meta (מוצפן).

שני סודות שונים

אל תתבלבלו: Access Token מאמת קריאות API (שליחה, תבניות), בעוד App Secret מאמת את ה-webhooks הנכנסים. ערבוב ביניהם גורם לכך ששליחה עובדת אך webhooks נכשלים, או להפך.
אימות

Webhook ואימות

כתובת ה-callback ייחודית לטננט:

text
https://shipnest.io/api/webhooks/meta/{tenantId}
  1. handshake (GET): Meta שולחת hub.verify_token + hub.challenge. Shipnest משווה ל-Verify Token שלכם (השוואה בזמן קבוע) ומחזירה את ה-challenge בהצלחה.
  2. אירועים (POST): כל בקשה חתומה ב-X-Hub-Signature-256 (HMAC-SHA256 עם ה-App Secret). חתימה שגויה — נדחית.

Fail-closed

אם ה-App Secret חסר או החתימה לא תואמת — הבקשה נדחית (403). ודאו שה-Verify Token זהה בין Meta ל-Shipnest, אחרת לא יגיעו אירועים כלל.
הודעות

נכנס ויוצא

נכנס: טקסט, מדיה (תמונה/וידאו/מסמך/סטיקר), הודעות קוליות (עם תמלול אוטומטי), לחיצות כפתור, מיקום ואנשי קשר — כולם נשמרים ומקובצים לפי מספר טלפון, ומזינים את הבוט ואת תיבת הדואר העסקית.

יוצא: שני סוגים — הודעות session (טקסט חופשי, רק בתוך חלון 24 השעות) והודעות תבנית(מאושרות מראש, ניתן לשלוח גם מחוץ לחלון).

חלון 24 השעות

Meta מאפשרת טקסט חופשי רק בתוך 24 שעות מאז ההודעה האחרונה של הלקוח. מחוצה לו — חובה להשתמש בתבנית מאושרת (אחרת שגיאה 131047 — מחוץ לחלון 24 שעות).
תבניות

אישור תבניות

כל תבנית חייבת אישור מ-Meta לפני שליחה. הזרימה:

  1. כותבים תבנית מקומית עם פרמטרים ({{customer_name}}, {{barcode}}).
  2. Shipnest מתרגמת לפורמט המיקומי של Meta ({{1}}, {{2}}), מייצרת ערכי דוגמה, ומגישה לאישור.
  3. Meta בודקת (דקות עד ימים). הסטטוס: PENDING → APPROVED / REJECTED.
  4. לאחר אישור, התבנית נקשרת לתבנית המקומית ומשמשת אוטומטית בשליחה.

כללי Meta לתבניות

Meta אוסרת על פרמטר בתחילת התבנית או בסופה, ועל גוף ריק. שם התבנית ב-Meta חייב אותיות לועזיות קטנות, ספרות וקו תחתון בלבד, ואינו יכול להתחיל בספרה. Shipnest מאמתת זאת לפני ההגשה.
legacy

Green API

Green API היה ספק ה-WhatsApp המקורי של Shipnest. Meta Cloud API הוא המסלול הרשמי והמומלץ לחיבורים חדשים, אך שני הספקים יכולים לדור יחד: ניתן להגר בהדרגה, ובחירת הערוץ נעשית אוטומטית — אם לתבנית יש קישור ל-Meta והספק מחובר, נבחר Meta; אחרת Green API. טקסט חופשי (ללא תבנית) זמין רק דרך Green API. ראו ערוצי שליחה.

מלכודות

נקודות לתשומת לב

  • רישום מספר: המספר חייב להיות רשום ומאומת ב-Meta Business, אחרת שגיאה 131026.
  • תפוגת טוקן: Access Token שפג — כל השליחות נכשלות (שגיאה 190); יש לחדש ולעדכן בהגדרות.
  • WABA ID חובה ל-webhooks: בלעדיו לא יגיעו עדכוני אישור תבניות.
  • תפוגת מדיה: קישורי מדיה מ-Meta פגים תוך שעות; כדאי לאחסן מדיה לצמיתות.