מספרים בתיבת ההודעות ו-Webhooks להודעות נכנסות

בדף מספרים בתיבת ההודעות בוחרים אילו ממספרי ה-WhatsApp שלכם מסתנכרנים לתיבת ההודעות Unibox, שבה הצוות שלכם קורא את הצ׳אטים שלהם ועונה עליהם. אם תגדירו למספר כתובת Webhook, ‏WbizTool גם תשלח לשרת שלכם כל הודעה חדשה שהוא מקבל או שולח, כ-JSON חתום: לתיעוד שיחות ב-CRM, להתראה לצוות או להפעלה של מענה אוטומטי.

בונים את הצד המקבל? עברו אל איך ה-Webhooks נמסרים, אימות החתימה ומטען ה-Webhook.

מי יכול לעשות את זה: בעלים ועורכים מוסיפים מספרים, משנים Webhooks ורואים את סוד ה-Webhook. אנליסטים לא רואים את מספרים בתיבת ההודעות בסרגל הצד. נדרש תוסף Unibox: ‏20$ לחודש או 200$ לשנה לפי המחירון בארה״ב לכל מספר בתיבת ההודעות (המחיר שלכם מוצג בדף חיוב ותוכניות), שבעלים מוסיפים לתוכנית בתשלום או לתוכנית לכל החיים בדף חיוב ותוכניות (ראו תוספים). הכמות שלו היא מספר המספרים שיכולים להיות בתיבת ההודעות בו-זמנית.

פתחו את מספרים בתיבת ההודעות תחת תיבת הודעות בסרגל הצד, או עברו אל /unibox/listeners/.

לפני שמתחילים#

• תוסף Unibox עם מספר פנוי בתיבת ההודעות: בשורה שמתחת לכותרת הדף כתוב, למשל, "2 מתוך 3 מספרים בתיבת ההודעות בשימוש (תוסף Unibox)", או "אין תוסף Unibox" (ראו בלי תוסף Unibox).
• מספר WhatsApp שחובר עם קוד QR או קוד צימוד, ומוצג כמחובר בדף מספרי WhatsApp. אי אפשר להוסיף מספרים שחוברו דרך תוסף הדפדפן. אפשר להוסיף חשבון Telegram מחובר כמו מספר.
• בשביל Webhook: כתובת https://‎ של עד 500 תווים באינטרנט הציבורי (לא localhost ולא רשת פרטית), שמקבלת בקשות POST עם גוף JSON ועונה ב-2xx תוך 8 שניות.

הוספת מספר לתיבת ההודעות#

1. פתיחת החלון

   לחצו על הוספת מספר לתיבת ההודעות בפינה השמאלית העליונה של הדף.

2. בחירת המספר

   בחרו אותו תחת מספר WhatsApp. ברשימה מופיעים המספרים המחוברים שלכם שעדיין לא נמצאים בתיבת ההודעות.

3. הוספת Webhook (לא חובה)

   הקלידו את הכתובת שלכם תחת כתובת URL של ה-Webhook (לא חובה). אז יופיע הודעות לשליחה: השאירו מסומנות את הודעות שהתקבלו, את הודעות שנשלחו או את שתיהן. אפשר להוסיף או לשנות את ה-Webhook בהמשך.

   

4. הוספה

   לחצו על הוספת מספר. תופיע ההודעה "המספר נוסף – הצ׳אטים שלו יתחילו להסתנכרן תוך כמה דקות." אם הזנתם כתובת Webhook, ייפתח סוד ה-Webhook שלכם: לחצו על העתקה ושמרו את הסוד במקום שהשרת שלכם יכול לקרוא אותו. אפשר להציג אותו שוב בהמשך בהגדרות Webhook.

• רק הודעות חדשות. מספר מסתנכרן מהרגע שמוסיפים אותו: הודעות ישנות יותר לא מיובאות ולא נשלחות.
• כל המספרים בשימוש? בחלון כתוב "כל המספרים בתיבת ההודעות בשימוש. אפשר לעצור או להסיר אחד, או להוסיף עוד מספרים לתוסף Unibox." עצרו או הסירו מספר, או בקשו מאחד הבעלים להגדיל את הכמות של התוסף (צפייה בתוספים).
• הוספה מחדש של מספר שהוסר מחזירה את תיבת ההודעות שלו ("המספר נוסף מחדש – הצ׳אטים שלו יסונכרנו שוב מעכשיו."); הודעות מהזמן שבו הוא היה מוסר לא נקלטות. עם כתובת Webhook, הוא שומר על הסוד הקודם שלו אם היה לו סוד (השתמשו בהצגה בהגדרות Webhook); אחרת ייפתח סוד ה-Webhook שלכם עם סוד חדש.

מה מוצג בכרטיס של מספר#

כל כרטיס מציג את המספר, מתי WbizTool בדקה לאחרונה אם יש בו הודעות ("נבדק לאחרונה לפני 1 דק׳", או לא נבדק אף פעם), את הודעות ואת אנשי קשר מסונכרנים (כל צ׳אט שסונכרן ממנו, כולל כאלה שאין להם הודעות בתיבת ההודעות), את הודעה אחרונה, ואת Webhook: הכתובת ומה נשלח אליה, למשל "שולח כל הודעה שמתקבלת ונשלחת · חתום עם סוד", או "אין – ההודעות מופיעות רק בתיבת ההודעות." תג Zapier אומר ש-Zap מקבל את ההודעות (ראו Zapier והמספרים בתיבת ההודעות).

התג בפינה השמאלית העליונה מציין מה המספר עושה:

שינוי כתובת ה-Webhook או ההודעות שנשלחות#

1. פתיחת הגדרות ה-Webhook

   לחצו על הגדרות Webhook בכרטיס של המספר.

2. שינוי ההגדרות

   ערכו את כתובת URL של ה-Webhook (לא חובה) ואת הסימונים תחת הודעות לשליחה. כדי לכבות את ה-Webhook, מחקו את הכתובת.

3. שמירה

   לחצו על שמירה. תופיע ההודעה "הגדרות ה-Webhook נשמרו."

   

• שינוי הכתובת שומר על הסוד. מחיקת הכתובת מוחקת אותו; כתובת שתתווסף בהמשך תקבל סוד חדש, שיוצג פעם אחת בסוד ה-Webhook שלכם.
• כששתי התיבות לא מסומנות, בכרטיס כתוב "לא נבחרו אירועים – שום דבר לא נשלח".

הצגת הסוד או יצירת סוד חדש#

הסוד מורכב מ-32 אותיות וספרות. בהגדרות Webhook, תחת סוד ה-Webhook, הכפתור הצגה חושף אותו, ולידו העתקה. יצירה מחדש שואל "ליצור סוד חדש? הסוד הנוכחי יפסיק לעבוד מיד – יש לעדכן אותו בכל מקום שבו מאמתים חתימות." לחצו על יצירת סוד חדש: הוא נשמר מיד ("נוצר סוד חדש."), בלי שמירה, וכל בקשה מאותו רגע נחתמת בו, כולל ניסיונות חוזרים של הודעות קודמות.

עצירה, הפעלה או הסרה של מספר#

Webhooks שממתינים לניסיון חוזר נמחקים כשעוצרים או מסירים את המספר או משנים את הכתובת שלו.

איך ה-Webhooks נמסרים#

• מתי: כל מספר בתיבת ההודעות נבדק בערך פעם בדקה כל עוד הוא מחובר; הבדיקות מושהות בזמן שהוא שולח הודעות, למשל קמפיין. הודעה נשלחת אחרי הבדיקה שמוצאת אותה, בדרך כלל תוך דקה או שתיים. אין כפתור בדיקה: שלחו הודעה למספר מטלפון אחר.
• בקשה אחת לכל הודעה: message_received עבור הודעות שהתקבלו; message_sent עבור הודעות שנשלחו, שנשלחו מהטלפון, מ-WhatsApp Web או על ידי WbizTool (קמפיינים, ה-API, תזכורות). תשובות שנשלחו מתיבת ההודעות Unibox בדרך כלל לא נשלחות: הן כבר נמצאות בתיבת ההודעות.
• הצלחה: כל סטטוס 2xx תוך 8 שניות. לא עוקבים אחרי הפניות: 3xx נחשב כשל.
• ניסיונות חוזרים: זמן קצוב שפג, שגיאת חיבור, 429 או 5xx מקבלים 3 ניסיונות חוזרים, אחרי 30 שניות, דקה ושתי דקות. תשובות אחרות, כמו 400 או 404, ותעודת TLS לא תקינה, לא מקבלות ניסיון חוזר.
• 410 Gone: ‏WbizTool מכבה את ה-Webhook של המספר (הכתובת והסוד נמחקים; ב-hook של Zapier, ה-Webhook הקודם שלכם חוזר). המספר ממשיך להסתנכרן לתיבת ההודעות.
• סדר וכפילויות: בקשות יכולות להגיע שלא לפי הסדר, ולעיתים רחוקות פעמיים. מיינו לפי message.whatsapp_timestamp ודלגו על message.id שכבר טיפלתם בו עבור אותו whatsapp_client_id. אם שניים מהמספרים שלכם נמצאים באותה קבוצה, כל אחד מהם שולח עותק משלו.
• הודעות מאוחרות: הודעה שנקלטת באיחור, למשל אחרי שהמספר מתחבר מחדש או אחרי הפסקה בבדיקות, נשלחת בכל זאת, ואם עברו יותר מ-10 דקות מאז שנשלחה, הערך של replayed בה הוא true. הודעות שהגיעו בזמן שהמספר היה עצור לא נשלחות אחרי הפעלה (ראו עצירה, הפעלה או הסרה של מספר).
• בדיקת כתובת: הכתובת נבדקת שוב לפני כל בקשה; לשרת שהכתובת שלו מפנה עכשיו לרשת פרטית, או שלא נפתרת, לא נשלחת בקשה, ואין ניסיון חוזר להודעה הזו.

כותרות#

אימות החתימה#

כל בקשה נחתמת בסוד ה-Webhook של המספר באמצעות HMAC-SHA256 על גוף הבקשה הגולמי בדיוק כפי שהתקבל. ה-digest ההקסדצימלי באותיות קטנות נשלח ב-X-Wbiztool-Signature בצורה sha256=<digest>‎. ל-Webhook שהוגדר בדף מספרים בתיבת ההודעות תמיד יש סוד, ולכן הכותרת תמיד נמצאת.

חשבו את החתימה מהבייטים הגולמיים לפני שאתם מפענחים את ה-JSON. פענוח הגוף וקידוד מחדש שלו משנים אותו (רווחים, תווים עם escape), והחתימה לא תתאים.

// Express: register this route before app.use(express.json()), or the raw body is lost
import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.WBIZTOOL_WEBHOOK_SECRET;

app.post("/wbiztool/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const received = req.get("X-Wbiztool-Signature") || "";

  const a = Buffer.from(received), b = Buffer.from(expected);
  const valid = a.length === b.length && crypto.timingSafeEqual(a, b);
  if (!valid) return res.status(401).send("Invalid signature");

  const data = JSON.parse(req.body.toString("utf8"));
  if (data.event === "message_received") {
    console.log(`New message from ${data.contact.phone}: ${data.message.content}`);
  }
  res.sendStatus(200); // answer quickly; do slow work in the background
});

app.listen(3000);

# Flask
import hashlib
import hmac
import json
import os

from flask import Flask, abort, request

app = Flask(__name__)
SECRET = os.environ["WBIZTOOL_WEBHOOK_SECRET"].encode()


@app.post("/wbiztool/webhook")
def wbiztool_webhook():
    raw_body = request.get_data()  # raw bytes, before parsing
    expected = "sha256=" + hmac.new(SECRET, raw_body, hashlib.sha256).hexdigest()
    received = request.headers.get("X-Wbiztool-Signature", "")
    if not hmac.compare_digest(expected, received):
        abort(401)

    data = json.loads(raw_body)
    if data["event"] == "message_received":
        print(f"New message from {data['contact']['phone']}: {data['message']['content']}")
    return "", 200

<?php
$secret   = getenv('WBIZTOOL_WEBHOOK_SECRET');
$rawBody  = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
$received = $_SERVER['HTTP_X_WBIZTOOL_SIGNATURE'] ?? '';

if (!hash_equals($expected, $received)) {
    http_response_code(401);
    exit('Invalid signature');
}

$data = json_decode($rawBody, true);
if ($data['event'] === 'message_received') {
    error_log('New message from ' . $data['contact']['phone'] . ': ' . $data['message']['content']);
}
http_response_code(200);

כדי לבדוק את הצד המקבל לפני שמגיעה הודעה אמיתית, חתמו בעצמכם על גוף ושלחו אותו:

BODY='{"event":"message_received","message":{"content":"Test"},"contact":{"phone":"12125550120"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$WBIZTOOL_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST https://your-server.example/wbiztool/webhook -H 'Content-Type: application/json' -H "X-Wbiztool-Signature: sha256=$SIG" -d "$BODY"

החתימה מכסה את הגוף, כולל ה-timestamp שלו, שמשתנה בכל ניסיון. כדי לדחות בקשות שנשלחות שוב, דחו timestamp שעברו ממנו יותר מ-5 דקות ודלגו על message.id שכבר טיפלתם בו.

מטען ה-Webhook#

{
  "event": "message_received",
  "timestamp": "2026-10-15T10:30:31.482913+00:00",
  "replayed": false,
  "webhook_id": 51,
  "whatsapp_client_id": "101",
  "whatsapp_phone": "12125550101",
  "platform": "whatsapp",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Can I add a gift note to it?",
    "from": "12125550120",
    "from_name": "Emma Thompson",
    "to": "12125550101",
    "timestamp": "2026-10-15T10:30:04+00:00",
    "whatsapp_timestamp": 1792060204,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "12125550120",
    "lid": null,
    "phone_hidden": false,
    "name": "Emma Thompson",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "10314",
    "name": "Lumen & Wick"
  }
}

{
  "event": "message_sent",
  "timestamp": "2026-10-15T10:34:22.117205+00:00",
  "replayed": false,
  "webhook_id": 51,
  "whatsapp_client_id": "101",
  "whatsapp_phone": "12125550101",
  "platform": "whatsapp",
  "message": {
    "id": "[email protected]_3EB0F9E8D7C6B5A40312",
    "type": "chat",
    "content": "Of course! Send us the text and we'll print it on a card.",
    "from": "12125550120",
    "from_name": "Emma Thompson",
    "to": "12125550101",
    "timestamp": "2026-10-15T10:33:40+00:00",
    "whatsapp_timestamp": 1792060420,
    "direction": "outgoing",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "12125550120",
    "lid": null,
    "phone_hidden": false,
    "name": "Emma Thompson",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "10314",
    "name": "Lumen & Wick"
  }
}

{
  "event": "message_received",
  "timestamp": "2026-10-15T10:35:48.904311+00:00",
  "replayed": false,
  "webhook_id": 51,
  "whatsapp_client_id": "101",
  "whatsapp_phone": "12125550101",
  "platform": "whatsapp",
  "message": {
    "id": "[email protected]_3EB0A7B6C5D4E3F20109",
    "type": "image",
    "content": "📸 Image",
    "from": "12125550122",
    "from_name": "Sofia Martinez",
    "to": "12125550101",
    "timestamp": "2026-10-15T10:34:51+00:00",
    "whatsapp_timestamp": 1792060491,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0,
    "media": {
      "filename": "",
      "mimetype": "image/jpeg",
      "size": 245760,
      "url": "https://wbiztool-static.s3.ap-southeast-1.amazonaws.com/unibox/10314/media/false_12125550122%40c.us_3EB0A7B6C5D4E3F20109.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=…&X-Amz-Date=20261015T103548Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=…"
    }
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "12125550122",
    "lid": null,
    "phone_hidden": false,
    "name": "Sofia Martinez",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "10314",
    "name": "Lumen & Wick"
  }
}

{
  "event": "message_received",
  "timestamp": "2026-10-15T10:39:40.330187+00:00",
  "replayed": false,
  "webhook_id": 51,
  "whatsapp_client_id": "101",
  "whatsapp_phone": "12125550101",
  "platform": "whatsapp",
  "message": {
    "id": "[email protected][email protected]",
    "type": "chat",
    "content": "Will there be a larger size?",
    "from": "120363041234567890",
    "from_name": "Lumen VIP Club",
    "to": "12125550101",
    "timestamp": "2026-10-15T10:39:02+00:00",
    "whatsapp_timestamp": 1792060742,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0,
    "sender": {
      "phone": "12125550126",
      "name": "Olivia Brooks",
      "phone_hidden": false
    }
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "120363041234567890",
    "lid": null,
    "phone_hidden": false,
    "name": "Lumen VIP Club",
    "is_group": true,
    "is_business": false
  },
  "organisation": {
    "id": "10314",
    "name": "Lumen & Wick"
  },
  "group": {
    "name": "Lumen VIP Club"
  }
}

המספרים, המזהים והשמות שלמעלה הם דוגמאות. הגוף האמיתי הוא שורה אחת של JSON דחוס, וכל תו שאינו ASCII (אותיות עם סימנים, כתבים אחרים, אימוג׳י) מגיע כ-escape בצורה ‎\uXXXX, למשל ‎\ud83d\udcf8 עבור 📸. ייתכן שיתווספו שדות נוספים; התעלמו משדות שאתם לא משתמשים בהם.

שדות ברמה העליונה#

השדות של message#

השדות של contact#

Zapier והמספרים בתיבת ההודעות#

הטריגר Incoming WhatsApp Message של WbizTool ב-Zapier משתמש ב-Webhooks האלה. הפעלת Zap מוסיפה את המספר לתיבת ההודעות אם צריך (ותופסת אחד מהמספרים בתיבת ההודעות שלכם) ומפנה את ה-Webhook שלו אל Zapier, להודעות שהתקבלו בלבד, עם סוד משלו; בכרטיס מוצג תג Zapier. כתובת ה-Webhook, הסוד והסימונים שלכם חוזרים כשה-Zap כבה.

אחר כך הגדרות Webhook מזהיר: "ה-Webhook הזה שייך ל-Zap של Zapier. שינוי או הסרה של הכתובת יעצרו את קבלת ההודעות ב-Zap." גם עצירה והסרה מזהירים: ה-Zap נשאר פעיל ב-Zapier אבל לא מקבל כלום, ולכן כבו אותו ב-Zapier במקום זאת. ראו איך הטריגר עובד עם המספרים בתיבת ההודעות שלכם.

בלי תוסף Unibox#

בדף כתוב "אין תוסף Unibox" ו-"תוסף Unibox לא פעיל בסביבת העבודה הזו.", והוספת מספר לתיבת ההודעות פותח את נדרש תוסף Unibox: "כדי להוסיף מספרי WhatsApp לתיבת ההודעות המשותפת ולקבל את ההודעות שלהם ב-Webhook, יש להירשם לתוסף Unibox." בעלים לוחצים על צפייה בתוספים ומוסיפים את התוסף מספר טלפון ל-Unibox בדף חיוב ותוכניות, בתוכנית בתשלום או בתוכנית לכל החיים (לא בתקופת הניסיון החינמית).

כשהתוסף מסתיים או כשמספר מתנתק#

• התוסף מסתיים: כל המספרים בתיבת ההודעות נעצרים, מיד או תוך כשעה. בכרטיסים מוצג נעצר עם "נעצר כי תוסף Unibox לא פעיל בסביבת העבודה הזו." הבעלים והעורכים מקבלים הודעה על תיבות ההודעות שנעצרו, באימייל החיוב או בהתראה "חלק מהמספרים או מהתכונות של … הופסקו" (בעיות במספר ובשליחה בהתראות). השיחות, כתובות ה-Webhook והסודות נשמרים: כשהתוסף חוזר, לחצו על הפעלה בכל מספר. הודעות מהזמן שבו הוא היה עצור נוספות אז לתיבת ההודעות, עד 30 יום אחורה, אבל לא נשלחות ל-Webhook שלכם.
• התוסף מכסה פחות מספרים ממה שפועל: "יותר מספרים פועלים ממה שהתוסף שלכם מאפשר. המספרים העודפים החדשים ביותר ייעצרו אוטומטית תוך כשעה."
• המספר מתנתק: בכרטיס מוצג המספר מנותק ושום דבר לא מסתנכרן ולא נשלח. אחרי שתחברו אותו מחדש, הודעות שהגיעו בינתיים נקלטות ונשלחות גם הן; בהודעות שעברו יותר מ-10 דקות מאז שנשלחו, הערך של replayed הוא true.
• הוא חובר מחדש עם טלפון אחר: המספר בתיבת ההודעות וה-Webhook שלו ממשיכים עבור המספר החדש (אותו whatsapp_client_id, ‏whatsapp_phone חדש) מאותו רגע; הצ׳אטים הישנים נשארים בתיבת ההודעות כהיסטוריה.

פתרון בעיות#

מדריכים קשורים#

• תיבת ההודעות Unibox: קריאה ומענה לצ׳אטים של המספרים בתיבת ההודעות שלכם
• אינטגרציה עם Zapier
• חיבור מספר ה-WhatsApp שלכם
• תוכניות וחיובים
• ה-API לשליחת הודעות: השדה webhook שלו מדווח אם הודעה שאתם שולחים יצאה (Webhook אחר)