אינטגרציות
אינטגרציה עם Zapier
אפליקציית WbizTool ב-Zapier מחברת את מספר ה-WhatsApp שלכם לאפליקציות האחרות שאתם משתמשים בהן. הפעילו Zap כשמגיעה הודעת WhatsApp, או שלחו הודעת WhatsApp כשמשהו קורה באפליקציה אחרת.
לפני שמתחילים#
- חשבון WbizTool עם מספר WhatsApp מחובר בדף WhatsApp settings (הגדרות WhatsApp).
- ה-Client ID (מזהה לקוח) וה-API key (מפתח API) שלכם מהדף Settings → API keys (הגדרות ← מפתחות API).
- לטריגר של הודעות נכנסות: חבילת התוספת Unibox בתוכנית שלכם. ראו דרישות הטריגר.
חיבור החשבון#
הוסיפו את WbizTool ל-Zap
ב-Zapier, צרו Zap וחפשו את WbizTool כאפליקציית הטריגר או הפעולה.
התחברו
כש-Zapier מבקש לחבר חשבון, הזינו את ה-Client ID וה-API key שלכם מהדף Settings → API keys.
מפתח ה-API קובע באיזו סביבת עבודה Zapier משתמש. אם אתם חברים ביותר מסביבת עבודה אחת, השתמשו במפתח שנוצר בסביבת העבודה שאתם רוצים לחבר. אם מזהה הלקוח או מפתח ה-API שגויים, Zapier מציג את השגיאה בזמן החיבור, למשל Auth Error: invalid api key.
טריגר של הודעת WhatsApp נכנסת#
הטריגר הזה מפעיל את ה-Zap בכל פעם שמישהו שולח הודעה לאחד ממספרי ה-WhatsApp שלכם. השתמשו בו כדי להוסיף צ'אטים חדשים ל-CRM, לפרסם הודעות בערוץ של הצוות או לתעד שיחות בגיליון.
בחרו את הטריגר
בחרו את WbizTool כאפליקציה ואת Incoming WhatsApp Message (הודעת WhatsApp נכנסת) כאירוע הטריגר.
בחרו מספר WhatsApp
תחת WhatsApp Number (מספר WhatsApp), בחרו את המספר המחובר שההודעות הנכנסות אליו יפעילו את ה-Zap. הרשימה מציגה את מספרי הטלפון שמחוברים בסביבת העבודה שלכם.
בדקו את הטריגר
לחצו על Test trigger (בדיקת הטריגר). Zapier טוען את ההודעות האחרונות שהתקבלו במספר הזה, כדי שתוכלו למפות שדות אמיתיים בשלבים הבאים. אם עדיין אין הודעות במספר, Zapier מציג במקום זאת הודעה לדוגמה.
הפעילו את ה-Zap
פרסמו את ה-Zap. WbizTool מתחברת ל-Zapier באופן אוטומטי. אין צורך להוסיף כתובת Webhook בשום מקום ב-WbizTool.
דרישות הטריגר#
- חבילת התוספת Unibox. הטריגר מוסיף את המספר שלכם לתיבת ההודעות Unibox (כמספר בתיבת ההודעות). בלי חבילת התוספת, הפעלת ה-Zap נכשלת עם השגיאה
Unibox add-on subscription required. רכשו אותה בדף Billing & Plans (חיובים ותוכניות): 20$ לחודש או 200$ לשנה לכל מספר WhatsApp שמשמש ב-Unibox. - מספר פנוי בתיבת ההודעות. אם המספר עדיין לא נמצא בתיבת ההודעות, הוא תופס אחד מהמספרים בתיבת ההודעות שחבילת התוספת שלכם מאפשרת. מספר שכבר נמצא בתיבת ההודעות לא תופס מספר נוסף.
- תפקיד Owner או Editor. מפתח ה-API חייב להיות שייך ל-Owner (בעלים) או ל-Editor (עורך) של סביבת העבודה.
- מספר WhatsApp מחובר. המספר חייב להישאר מחובר כדי שהודעות חדשות ייקלטו.
איך הטריגר עובד עם המספרים בתיבת ההודעות שלכם#
- רק הודעות נכנסות מפעילות את ה-Zap. הודעות שנשלחות מהמספר שלכם לא מפעילות אותו.
- נשלחות רק הודעות שהתקבלו אחרי שהפעלתם את ה-Zap. הודעות ישנות יותר לא נשלחות מחדש.
- אם המספר כבר נמצא בתיבת ההודעות עם כתובת Webhook משלכם, ה-Webhook של Zapier תופס את מקומה כל עוד ה-Zap פועל. כשאתם מכבים את ה-Zap, כתובת ה-Webhook, הסוד והגדרות האירועים שלכם חוזרים למקומם.
- אם אתם מוחקים Zap בלי לכבות אותו קודם, WbizTool מפסיקה לשלוח אליו ברגע ש-Zapier מדווח שה-Zap כבר לא קיים.
- בדף מספרים בתיבת ההודעות, ה-Webhook של המספר מוצג עם תג Zapier. אם תלחצו שם על עצירה או על הסרה של המספר, ה-Zap יישאר פועל ב-Zapier אבל לא יקבל הודעות, והדף יזהיר אתכם לפני כן. כדי לעצור את ה-Zap, כבו אותו ב-Zapier במקום זאת. כדי שההודעות יתחילו להגיע שוב אחרי מחיקת המאזין, כבו את ה-Zap והפעילו אותו מחדש ב-Zapier.
הסבר על אופן הפעולה של מספרים בתיבת ההודעות ו-Webhooks מופיע במדריך Webhooks להודעות נכנסות.
נתוני הטריגר#
כל הרצה של ה-Zap מקבלת הודעה אחת, כמו זו:
{
"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",
"lid": null,
"phone_hidden": false,
"name": "Aman",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "5021",
"name": "Acme Stores"
}
}| שדה | תיאור |
|---|---|
whatsapp_phone | מספר ה-WhatsApp שלכם שקיבל את ההודעה. |
message.type | הערך chat לטקסט. הודעות מדיה משתמשות בסוגים כמו image, video, audio, ptt (הודעה קולית), document ו-sticker. |
message.content | הטקסט. במדיה, תווית קצרה כמו "📸 Image". |
message.from | המספר של השולח, בלי +. ריק כש-WhatsApp מסתירה אותו (ראו למטה). |
contact.phone | המספר של איש הקשר, בלי +. ריק כש-WhatsApp מסתירה אותו. |
contact.lid | מזהה הפרטיות של WhatsApp עבור איש הקשר, כמו 62337239240946@lid, כש-WhatsApp משתמשת בו. אחרת null. |
contact.phone_hidden | הערך true כש-WhatsApp לא משתפת את המספר של איש הקשר. |
contact.is_group | הערך true כשההודעה הגיעה מקבוצה. הודעות קבוצה כוללות גם את group.name. |
חלק מההודעות כוללות שדות נוספים: message.media (שם הקובץ, סוגו, גודלו ו-url, קישור הורדה שעובד 7 ימים) במדיה, message.quoted_message_id בתשובות ו-group בהודעות קבוצה. כדי לשמור קובץ, העתיקו אותו בתוך 7 הימים האלה (למשל עם שלב העלאה ל-Google Drive או ל-Dropbox).
דוגמה: תיעוד הודעות נכנסות ב-Google Sheets#
- טריגר: WbizTool, Incoming WhatsApp Message.
- פעולה: Google Sheets, Create Spreadsheet Row (יצירת שורה בגיליון). מפו את Contact Phone (טלפון איש הקשר) לעמודת Phone, את Contact Name (שם איש הקשר) לעמודת Name ואת Message Content (תוכן ההודעה) לעמודת Message.
שליחת הודעות WhatsApp מ-Zap#
הוסיפו את WbizTool כפעולה ובחרו אחד מאירועי הפעולה האלה:
| פעולה | מה היא שולחת |
|---|---|
| Send Text-Only WhatsApp Message | הודעת טקסט. |
| Send Image File With Text on WhatsApp | תמונה מכתובת URL ציבורית של תמונה, עם כיתוב אופציונלי. |
| Send PDF File With Text on WhatsApp | קובץ מכתובת URL ציבורית, עם הודעה אופציונלית. |
| Send Advanced WhatsApp Message | טקסט, תמונה או קובץ, עם Webhook סטטוס אופציונלי. |
| Send WhatsApp Message on Group | הודעה לקבוצת WhatsApp, לפי השם המדויק של הקבוצה. |
בכל פעולה, בחרו את המספר השולח תחת WhatsApp Number. הזינו את מספר הטלפון של הנמען עם קידומת המדינה, למשל 919876543210, או הכניסו את קידומת המדינה לשדה האופציונלי Country Code (קידומת מדינה), למשל 91. לפעולה Send WhatsApp Message on Group אין שדה טלפון או קידומת מדינה; במקום זאת היא מקבלת את Group Name (שם הקבוצה).
כש-WbizTool לא יכולה לקבל הודעה, השלב נכשל ו-Zapier מציג את הסיבה, למשל WbizTool: Invalid phone number או WbizTool: Not enough credits. שלב שהצליח פירושו שההודעה נכנסה לתור. לאחר מכן WbizTool שולחת אותה מהמספר המחובר שלכם.
אפשר גם לקרוא ל-API ישירות באמצעות Webhooks by Zapier:
| הגדרה | ערך |
|---|---|
| Action event | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| Payload type | json או form |
| Data | client_id, api_key, whatsapp_client, country_code, phone, msg |
המשמעות של כל שדה מוסברת במדריך שליחת הודעות WhatsApp מכל כלי אוטומציה, וכל האפשרויות מפורטות בדף שליחת הודעה.
פתרון בעיות#
| בעיה | מה לבדוק |
|---|---|
Auth Error: invalid api key | המפתח נמחק, הוקלד בטעות או לא תואם למזהה הלקוח. צרו מפתח חדש בדף Settings → API keys וחברו מחדש. |
This API key is not linked to a workspace. Create a new API key in WbizTool. | המפתח שייך להגדרת חשבון ישנה. צרו מפתח חדש בדף Settings → API keys וחברו מחדש. |
Unibox add-on subscription required | רכשו את חבילת התוספת Unibox בדף Billing & Plans, ואז הפעילו שוב את ה-Zap. |
Unibox numbers limit reached for your plan. Remove a listener or upgrade to connect this number. | כל המספרים בתיבת ההודעות שלכם בשימוש. הסירו מספר שאינכם צריכים עוד בדף מספרים בתיבת ההודעות, או הגדילו את הכמות של חבילת התוספת. |
Only workspace owners and editors can connect Zapier triggers | חברו מחדש את Zapier עם מפתח API שנוצר על ידי Owner או Editor של סביבת העבודה. |
Invalid WhatsApp client | המספר שנבחר בטריגר לא מחובר כרגע. חברו אותו מחדש בדף WhatsApp settings. |
Invalid phone number או Phone number is invalid | המספר של הנמען שגוי או חסרה בו קידומת המדינה. השתמשו בספרות בלבד, למשל 919876543210, או מלאו את Country Code. |
Not enough credits | סביבת העבודה בתוכנית החינמית ולא נותרו בה הודעות. בחרו תוכנית בדף Billing & Plans: תוכניות בתשלום שולחות הודעות ללא הגבלה. |
Daily limit reached: … | מספר ה-WhatsApp קיבל 1,000 הודעות ב-24 השעות האחרונות (שימוש הוגן). שלחו את השאר מאוחר יותר או ממספר אחר. |
| ה-Zap פועל אבל לא מופעל | המספר חייב להישאר מחובר. בדקו אותו בדף WhatsApp settings, ובדקו שהמספר נמצא בדף מספרים בתיבת ההודעות, מציג Zapier ומוצג כמסתנכרן. אם הוא הוסר או שלא מוצג בו התג Zapier, כבו את ה-Zap והפעילו אותו מחדש ב-Zapier. ההודעות נקלטות תוך כמה דקות. |
| Contact Phone ריק | WhatsApp מסתירה את המספר של איש הקשר הזה. ראו כשמספר הטלפון מוסתר. |