דלגו לתוכן
Wbiztool

אינטגרציות

אינטגרציה עם Zapier

אפליקציית Wbiztool ב-Zapier מחברת את מספר ה-WhatsApp שלכם לאפליקציות האחרות שאתם משתמשים בהן. הפעילו Zap כשמגיעה הודעת WhatsApp, או שלחו הודעת WhatsApp כשמשהו קורה באפליקציה אחרת.

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

  • חשבון Wbiztool עם מספר WhatsApp מחובר בדף WhatsApp settings (הגדרות WhatsApp).
  • ה-Client ID (מזהה לקוח) וה-API key (מפתח API) שלכם מהדף Settings → API keys (הגדרות ← מפתחות API).
  • לטריגר של הודעה חדשה: חבילת התוספת Unibox בתוכנית שלכם. ראו דרישות הטריגר.

חיבור החשבון#

  1. הוסיפו את Wbiztool ל-Zap

    ב-Zapier, צרו Zap וחפשו את Wbiztool כאפליקציית הטריגר או הפעולה.

  2. התחברו

    כש-Zapier מבקש לחבר חשבון, הזינו את פרטי הגישה שהוא מבקש, כלומר את מפתח ה-API ואת מזהה הלקוח, מהדף Settings → API keys.

מפתח ה-API קובע באיזו סביבת עבודה Zapier משתמש. אם אתם חברים ביותר מסביבת עבודה אחת, השתמשו במפתח שנוצר בסביבת העבודה שאתם רוצים לחבר.

טריגר של הודעת WhatsApp חדשה#

הטריגר הזה מפעיל את ה-Zap בכל פעם שמתקבלת הודעה במספר ה-WhatsApp שלכם. השתמשו בו כדי להוסיף צ'אטים חדשים ל-CRM, לפרסם הודעות בערוץ של הצוות או לתעד שיחות בגיליון.

דרישות הטריגר#

  • חבילת התוספת Unibox. בלעדיה, הפעלת ה-Zap נכשלת עם השגיאה Unibox add-on subscription required. רכשו אותה בדף Billing & Plans (חיובים ותוכניות): 20$ לחודש או 200$ לשנה לכל מספר WhatsApp שמשמש ב-Unibox.
  • מספר WhatsApp מחובר. הטריגר משויך לאחד מהמספרים המחוברים שלכם.

נתוני הטריגר#

הודעות אמיתיות נראות כך:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

הדוגמה ש-Zapier טוען בזמן הגדרת הטריגר כוללת את אותם שדות message ו-contact (חוץ מ-message.forwarding_score), אבל בלי webhook_id, ‏whatsapp_client_id, ‏whatsapp_phone או organisation. השדות האלה זמינים למיפוי רק אחרי שמגיעה הודעה אמיתית. הדוגמה גם משתמשת בערכי מציין מקום: מספרי טלפון עם +, ‏whatsapp_timestamp באלפיות שנייה ו-status שמוגדר ל-delivered.

שדהתיאור
eventהערך message_received להודעות נכנסות, ו-message_sent להודעות שנשלחו מהמספר שלכם.
message.typeהערך chat לטקסט. הודעות מדיה משתמשות בסוגים כמו image, video, audio, ptt (הודעה קולית), document ו-sticker.
message.contentהטקסט. במדיה, תווית קצרה כמו "📸 Image".
message.directionהערך incoming או outgoing.
message.from / message.tofrom הוא תמיד איש הקשר ו-to הוא המספר שלכם, גם בהודעות יוצאות. השתמשו ב-message.direction כדי להבחין ביניהן.
contact.is_groupהערך true כשההודעה הגיעה מקבוצה. הודעות קבוצה כוללות גם את group.name.

בהודעות אמיתיות, מספרי הטלפון הם בלי +, הערך message.whatsapp_timestamp הוא בשניות, והערך של message.status הוא בדרך כלל pending. חלק מההודעות כוללות שדות נוספים: message.media (שם הקובץ, סוגו וגודלו) במדיה, message.quoted_message_id בתשובות ו-group בהודעות קבוצה. דוגמאות נוספות מופיעות במדריך מאזיני Webhook.

דוגמה: תיעוד הודעות נכנסות ב-Google Sheets#

  1. טריגר: ‏Wbiztool, ‏New WhatsApp Message.
  2. Filter by Zapier: המשיכו רק אם message.direction תואם בדיוק ל-incoming.
  3. פעולה: ‏Google Sheets, ‏Create Spreadsheet Row. מפו את contact.phone לעמודת Phone, את contact.name לעמודת Name ואת message.content לעמודת Message.

שליחת הודעות WhatsApp מ-Zap#

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

אפשר גם לקרוא ל-API ישירות באמצעות Webhooks by Zapier:

הגדרהערך
Action eventPOST
URLhttps://wbiztool.com/api/v1/send_msg/
Payload typejson או form
Dataclient_id, api_key, whatsapp_client, country_code, phone, msg

המשמעות של כל שדה מוסברת במדריך שליחת הודעות WhatsApp מכל כלי אוטומציה, וכל האפשרויות מפורטות בדף שליחת הודעה.

פתרון בעיות#

בעיהמה לבדוק
Invalid API keyהמפתח נמחק או הוקלד בטעות. צרו מפתח חדש בדף Settings → API keys וחברו מחדש.
Unibox add-on subscription requiredרכשו את חבילת התוספת Unibox בדף Billing & Plans, ואז הפעילו שוב את ה-Zap.
No available WhatsApp clientsלא הוגדר מספר בטריגר, ולכל מספר מחובר כבר יש מאזין Unibox, או שאין מספר מחובר. זה כולל את המאזין ש-Wbiztool יצרה בפעם הראשונה שהפעלתם את ה-Zap הזה: כיבוי Zap לא מוחק אותו, כך שהפעלה מחדש (למשל אחרי עריכת ה-Zap) עלולה להיכשל. מחקו מאזין שאינכם צריכים עוד, כמו זה, בדף Unibox listeners, או חברו מספר נוסף בדף WhatsApp settings.
Invalid WhatsApp clientהמספר שהוגדר בטריגר לא מחובר כרגע. חברו אותו מחדש בדף WhatsApp settings.
ה-Zap פועל אבל לא מופעלמספר ה-WhatsApp שלכם חייב להישאר מחובר כדי שהודעות חדשות ייקלטו. בדקו את המאזין בדף Unibox listeners.
‏Zapier מציג שגיאה כשאתם מכבים את ה-Zap, כמו Listener not found או שגיאת שרתזו בעיה ידועה. בדקו את המאזין בדף Unibox listeners כדי לראות אם כתובת ה-Webhook שלו הוסרה.