אינטגרציות
אינטגרציה עם 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 מבקש לחבר חשבון, הזינו את פרטי הגישה שהוא מבקש, כלומר את מפתח ה-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.to | from הוא תמיד איש הקשר ו-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#
- טריגר: Wbiztool, New WhatsApp Message.
- Filter by Zapier: המשיכו רק אם
message.directionתואם בדיוק ל-incoming. - פעולה: Google Sheets, Create Spreadsheet Row. מפו את
contact.phoneלעמודת Phone, אתcontact.nameלעמודת Name ואתmessage.contentלעמודת Message.
שליחת הודעות WhatsApp מ-Zap#
כדי לשלוח הודעה, הוסיפו את Wbiztool כפעולה ובחרו אחת מהפעולות שמופיעות בדף Wbiztool ב-Zapier. מפו את מספר הטלפון של הנמען ואת טקסט ההודעה משלבים קודמים.
אפשר גם לקרוא ל-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 מכל כלי אוטומציה, וכל האפשרויות מפורטות בדף שליחת הודעה.
פתרון בעיות#
| בעיה | מה לבדוק |
|---|---|
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 שלו הוסרה. |
