אינטגרציות
GoHighLevel ו-WhatsApp
חברו את GoHighLevel (HighLevel) ל-WbizTool, ותהליכי העבודה שלכם ישלחו הודעות WhatsApp ממספר ה-WhatsApp שלכם. הודעות WhatsApp נכנסות יכולות גם לחזור ל-HighLevel, כהערה, כתג או כמשימה אצל איש הקשר.
כל מה שבדף הזה משתמש ביכולות שכבר קיימות בשני הצדדים: ה-Webhooks של תהליכי העבודה ב-HighLevel, וה-API לשליחת הודעה וWebhooks להודעות נכנסות של WbizTool. לא צריך להתקין כלום.
מי יכול לעשות את זה: ב-WbizTool, בעלים יוצרים את מפתח ה-API (מפתחות API), ובעלים או עורכים מגדירים Webhooks להודעות נכנסות. ב-HighLevel, מי שיכול לערוך תהליכי עבודה בתת-החשבון (sub-account) בונה אותם. הסוכנות (agency) צריכה להפעיל את יכולות ה-premium של תהליכי העבודה ב-HighLevel (ראו לפני שמתחילים).
מה אפשר לעשות#
| כיוון | דוגמה | איך |
|---|---|---|
| מ-HighLevel ל-WhatsApp | נשלח טופס, נוסף תג או נקבעה פגישה, ואיש הקשר מקבל הודעת WhatsApp. | פעולת Custom Webhook בתהליך עבודה ב-HighLevel קוראת ל-API לשליחת הודעה של WbizTool. |
| מ-WhatsApp ל-HighLevel | לקוח שולח הודעה למספר ה-WhatsApp שלכם, וההודעה נוספת כהערה אצל איש הקשר שלו ב-HighLevel. אם איש הקשר עדיין לא קיים, הוא נוצר. | מספר בתיבת ההודעות של WbizTool שולח כל הודעה לטריגר Inbound Webhook של HighLevel. נדרש תוסף Unibox. |
לפני שמתחילים#
- מספר WhatsApp מחובר בדף מספרי WhatsApp, וה-WhatsApp Client ID שלו (המזהה שמוצג למספר), למשל
678. - מפתח API של WbizTool מהדף הגדרות ← מפתחות API. ב-HighLevel הוא נכנס לכותרת
Authorization: Bearer, כך שאין צורך ב-Client ID. ראו שליחת המפתח בכותרת. - יכולות ה-premium של תהליכי העבודה ב-HighLevel. HighLevel מגדירה את Custom Webhook ואת Inbound Webhook כיכולות premium של תהליכי עבודה. סוכנויות בכל תוכנית של HighLevel יכולות להפעיל אותן: ב-Agency View, עברו אל Settings → Company והפעילו את Workflow - Premium Features. HighLevel מחייבת כל הרצת premium, וכל תת-חשבון מקבל 100 הרצות premium בחינם (פעם אחת, לא כל חודש). הסוכנות יכולה לחייב על כך את תת-החשבון (rebilling). המחירים של HighLevel מופיעים בדף העזרה שלה.
- להודעות נכנסות בלבד: תוסף Unibox בתוכנית בתשלום או בתוכנית לכל החיים של WbizTool (לא בתקופת הניסיון החינמית). הוא עולה 20$ לחודש או 200$ לשנה לפי המחירון בארה״ב לכל מספר WhatsApp בתיבת ההודעות. בעלים מוסיפים אותו בדף חיוב ותוכניות (ראו תוספים).
בחירת מסלול#
המסלול של תהליכי העבודה ב-HighLevel הוא הקצר ביותר: HighLevel קוראת ל-WbizTool ישירות, בלי כלי נוסף באמצע. השתמשו בכלי אוטומציה רק אם תהליכי העבודה שלכם כבר רצים בו.
| מסלול | שליחה (מ-HighLevel ל-WhatsApp) | קבלה (מ-WhatsApp ל-HighLevel) | מה צריך |
|---|---|---|---|
| תהליכי עבודה ב-HighLevel (מומלץ) | פעולת Custom Webhook ← API לשליחת הודעה | Webhook של WbizTool ← הטריגר Inbound Webhook | יכולות ה-premium של תהליכי העבודה ב-HighLevel. קבלה: תוסף Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed ← WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message ← LeadConnector Add/Update Contact או Add Task | חשבון Zapier. קבלה: תוסף Unibox. |
| Make | פעולת Webhook של HighLevel ← Webhooks של Make ← מודול HTTP | Webhook של WbizTool ← Webhooks של Make ← ה-API של HighLevel | חשבון Make. קבלה: תוסף Unibox. |
| n8n | פעולת Webhook של HighLevel ← Webhook של n8n ← WbizTool Send Message | Webhook של WbizTool ← Webhook של n8n ← הצומת HighLevel | n8n עם צומת הקהילה של WbizTool. קבלה: תוסף Unibox. |
| Pabbly Connect | פעולת Webhook של HighLevel ← טריגר Webhook של Pabbly ← בקשת API (Pabbly) | Webhook של WbizTool ← טריגר Webhook של Pabbly ← השלב שלכם ב-HighLevel | חשבון Pabbly Connect. קבלה: תוסף Unibox. |
שליחת הודעות WhatsApp מתהליך עבודה ב-HighLevel#
פתיחה או יצירה של תהליך עבודה
בתת-החשבון שלכם ב-HighLevel, פתחו את Automation (אוטומציה) וצרו תהליך עבודה (workflow), או ערכו תהליך קיים. תנו לו את הטריגר הרצוי, למשל שליחת טופס, תג חדש או פגישה שנקבעה.
הוספת הפעולה Custom Webhook
לחצו על + במקום שבו ההודעה צריכה לצאת, ואז על Send Data → Custom Webhook (או חפשו בפעולות "webhook" ובחרו Custom Webhook). הפעולה הפשוטה Webhook לא יכולה להגדיר את הכותרת והגוף שה-API הזה צריך.
הגדרת הבקשה
הגדירו את Event ל-CUSTOM ואת Method ל-POST. הגדירו את URL ל-
https://wbiztool.com/api/v1/send_msg/. ב-Authorization, בחרו Bearer Token והדביקו את מפתח ה-API של WbizTool, או בחרו בלי אימות והוסיפו את הכותרתAuthorizationעם הערךBearer YOUR_API_KEY. הגדירו את Content-Type ל-application/json.הדבקת הגוף
הדביקו את אחד מהבלוקים להעתקה והדבקה ב-Raw Body והחליפו את
678ב-WhatsApp Client ID שלכם. השתמשו בסמל התג של HighLevel כדי להוסיף להודעה עוד שדות של איש הקשר.בדיקה ופרסום
שמרו את הפעולה ופרסמו את תהליך העבודה. הריצו אותו על איש קשר לבדיקה עם מספר הטלפון שלכם. כל הרצה מופיעה ביומני ההרצה (execution logs) של תהליך העבודה. כש-WbizTool מקבלת את ההודעה, היא עונה
"status": 1. אחר כך ההודעה יוצאת ממספר ה-WhatsApp שלכם.
שדה מספר הטלפון#
השתמשו ב-{{contact.phone_raw}}, לא ב-{{contact.phone}}. {{contact.phone}} של HighLevel מעוצב לקריאה, כמו (515) 555-2345, בלי קידומת המדינה. {{contact.phone_raw}} הוא אותו מספר בפורמט בינלאומי, כמו +15155552345.
WbizTool מסירה בשבילכם את ה-+, הרווחים, המקפים והסוגריים. מספר שנכתב עם + כבר כולל את קידומת המדינה שלו, כך שאין צורך לשלוח country_code. אם חלק מאנשי הקשר שלכם נשמרו בלי קידומת מדינה, הוסיפו לגוף "country_code": "1" (קידומת החיוג של המדינה שלכם). היא מתווספת רק למספרים שנכתבו בלי +. ראו שליחת הודעה ← phone.
בלוקים להעתקה והדבקה#
URL: https://wbiztool.com/api/v1/send_msg/ · Method: POST · Headers: Authorization: Bearer YOUR_API_KEY ו-Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: המזהה של המספר שממנו שולחים. אפשר להשמיט אותו רק כשבסביבת העבודה שלכם יש בדיוק מספר מחובר אחד.msg: עד 3,000 תווים. העיצוב של WhatsApp עובד:*bold*, _italic_. לשורה חדשה, הקלידו\nבתוך הטקסט. ירידת שורה אמיתית הופכת את ה-JSON ללא תקין.- תמונות וקבצים: הקישורים חייבים להיות ציבוריים.
msgהופך לכיתוב. ראו שליחת תמונות וקבצים. expire_after_seconds: אם ההודעה לא יצאה בתוך הזמן הזה, למשל כי המספר התנתק, היא מסומנת כפגת תוקף ולא נשלחת.- קבוצות:
group_nameהוא השם המדויק של קבוצת WhatsApp שהמספר שלכם חבר בה. שלחוgroup_nameאוphone, אף פעם לא את שניהם. ראו שליחה לקבוצה.
תיעוד הודעות WhatsApp נכנסות ב-HighLevel#
הכיוון הזה דורש את תוסף Unibox. כל הודעה שמספר ה-WhatsApp שלכם מקבל נשלחת לטריגר Inbound Webhook של HighLevel. תהליך העבודה מוצא או יוצר את איש הקשר ומוסיף את ההודעה כהערה, כתג או כמשימה. ההודעות לא מופיעות בשום מקום אחר ב-HighLevel.
יצירת תהליך עבודה עם טריגר Inbound Webhook
ב-HighLevel, צרו תהליך עבודה ובחרו את הטריגר Inbound Webhook. העתיקו את כתובת ה-Webhook שהוא מציג.
הפניית מספר ה-WhatsApp שלכם אליו
ב-WbizTool, פתחו את מספרים בתיבת ההודעות. לחצו על הוספת מספר לתיבת ההודעות, בחרו את המספר והדביקו את הכתובת מ-HighLevel תחת כתובת URL של ה-Webhook (לא חובה). למספר שכבר נמצא בתיבת ההודעות, הדביקו אותה בהגדרות Webhook של המספר. תחת הודעות לשליחה, סמנו רק את הודעות שהתקבלו. כל שליחה היא הרצת premium אחת ב-HighLevel, לכן השאירו את הודעות שנשלחו כבוי אלא אם אתם צריכים אותן.
שליחת הודעת בדיקה
מטלפון אחר, שלחו הודעה למספר ה-WhatsApp שלכם. היא נשלחת אחרי הבדיקה הבאה, בדרך כלל תוך דקה או שתיים. ב-HighLevel, לחצו על Test Trigger, בחרו את הבקשה תחת Mapping Reference ושמרו את הטריגר. השדות מפורטים במטען ה-Webhook.
דילוג על קבוצות ועל מספרים מוסתרים
הוסיפו שלב If/Else שממשיך רק כש-
eventהואmessage_received, contact.is_groupהואfalseו-contact.phoneלא ריק. לפעמים WhatsApp מסתירה את המספר של השולח, והודעות בקבוצות נושאות את מזהה הקבוצה במקום מספר טלפון.מציאה או יצירה של איש הקשר
בפעולה Create/Update Contact, הגדירו את Phone ל-
+ואחריו contact → phone מתוך הערכים של ה-Inbound Webhook. WbizTool שולחת את המספר בלי+, וה-+אומר ל-HighLevel שהמספר כולל את קידומת המדינה. אפשר גם למפות את contact → name. זה שם ה-WhatsApp של השולח, והוא עלול להחליף שם שערכתם ב-HighLevel.הוספת ההודעה לאיש הקשר
הוסיפו פעולה Add to Notes. כתבו הערה כמו "הודעת WhatsApp:" ובחרו message → content ו-message → timestamp מתוך הערכים של ה-Inbound Webhook. אפשר גם להוסיף Add Contact Tag (למשל
whatsapp), משימה או התראה פנימית לצוות.פרסום
פרסמו את תהליך העבודה ושלחו עוד הודעת בדיקה.
| ערך של Inbound Webhook | למה הוא משמש |
|---|---|
contact.phone | הטלפון של איש הקשר. הוסיפו + בהתחלה. |
contact.name | שם ה-WhatsApp של השולח. יכול להיות ריק. |
message.content | הטקסט. לתמונות, הודעות קוליות וקבצים זו תווית כמו 📸 Image, והכיתובים לא נכללים. |
message.timestamp | מתי ההודעה נשלחה ב-WhatsApp (ISO 8601, UTC). |
message.media.url | קישור להורדת תמונה או קובץ. תוקפו פג אחרי 3½ עד 7 ימים, לכן אל תסתמכו עליו בהערה. |
whatsapp_phone | איזה מהמספרים שלכם קיבל אותה, אם כמה מספרים שולחים לאותו תהליך עבודה. |
event | message_received או message_sent. |
- רק הודעות חדשות נשלחות, מהרגע שה-Webhook הוגדר. צ׳אטים ישנים יותר לא מיובאים.
- Webhook אחד לכל מספר. כל מספר בתיבת ההודעות שולח לכתובת אחת. אם Zap ב-Zapier משתמש בטריגר Incoming WhatsApp Message לאותו מספר, ה-Zap משתלט על ה-Webhook כל עוד הוא פועל.
- מענה מ-HighLevel: כדי לענות ב-WhatsApp מאותו תהליך עבודה, הוסיפו את הפעולה Custom Webhook עם
"phone": "{{contact.phone_raw}}". - שמרו את הכתובת בסוד. ה-Inbound Webhook של HighLevel לא בודק את החתימה של WbizTool, כך שכל מי שיש לו את הכתובת יכול לשלוח אליה. אם היא דלפה, צרו טריגר חדש והדביקו את הכתובת שלו ב-WbizTool.
Zapier#
האפליקציה של HighLevel ב-Zapier נקראת LeadConnector. יש לה טריגר אחד, Pipeline Stage Changed (שלב ב-pipeline השתנה). בין הפעולות שלה יש Add/Update Contact (הוספה/עדכון של איש קשר) ו-Add Task (הוספת משימה). לחיבור WbizTool ראו אינטגרציה עם Zapier.
- שליחה: טריגר LeadConnector Pipeline Stage Changed, אחריו שלב Filter by Zapier (סינון של Zapier) לשלב הרצוי, ואחריו WbizTool Send Text-Only WhatsApp Message. בחרו את המספר תחת WhatsApp Number, מפו את הטלפון של איש הקשר ל-Phone Number וכתבו את Message. לאירועים אחרים של HighLevel, השתמשו במקום זאת בפעולה Custom Webhook.
- קבלה: טריגר WbizTool Incoming WhatsApp Message (דורש את תוסף Unibox), אחריו שלב Filter by Zapier שממשיך רק כש-Contact Phone Hidden ו-Is Group הם false. אחר כך LeadConnector Add/Update Contact עם הטלפון מוגדר ל-
+ו-Contact Phone, ואז LeadConnector Add Task עם Message Content.
Make#
האפליקציה של HighLevel ב-Make נקראת GoHighLevel. התבניות האלה משתמשות רק במודולים הכלליים של Make Webhooks, JSON ו-HTTP, כך שאין צורך בחיבור GoHighLevel ב-Make. תבנית הקבלה צריכה במקום זאת טוקן של Private Integration ב-HighLevel ואת מזהה ה-location שלכם (ראו בהמשך).
ייבוא ה-blueprint
הורידו תבנית מהטבלה שלמטה. ב-Make, צרו תרחיש (scenario), פתחו את התפריט … ובחרו Import blueprint.
יצירת ה-Webhook
פתחו את המודול Webhooks, לחצו על Add כדי ליצור Webhook והעתיקו את הכתובת שלו.
מילוי ה-placeholders
החליפו כל placeholder באותיות גדולות במודולי ה-HTTP, כמו
YOUR_WBIZTOOL_API_KEYו-YOUR_WHATSAPP_CLIENT_ID.חיבור ה-Webhook
שליחה: ב-HighLevel, הוסיפו לתהליך העבודה פעולת Webhook עם הכתובת של Make כ-URL שלה. תחת Custom Data, הוסיפו את המפתח
phone_rawעם הערך{{contact.phone_raw}}. קבלה: הדביקו את הכתובת של Make ככתובת ה-Webhook של המספר בדף מספרים בתיבת ההודעות, כשרק הודעות שהתקבלו מסומן.הרצה אחת
לחצו על Run once ב-Make והפעילו את תהליך העבודה, או שלחו הודעת WhatsApp למספר שלכם.
תבנית הקבלה כותבת ל-HighLevel דרך ה-API שלה עם טוקן Private Integration מההגדרות של תת-החשבון, עם ה-scope contacts.write, ועם מזהה ה-location של תת-החשבון. אפשר במקום זאת להשתמש במודולים Create a Contact ו-Add a Note to the Contact של האפליקציה GoHighLevel.
n8n#
ב-n8n יש צומת מובנה HighLevel. הפעולה Contact → Create or Update שלו מוצאת איש קשר לפי טלפון או אימייל, או יוצרת אחד, ויכולה להוסיף Note. התקינו קודם את צומת הקהילה של WbizTool: ראו אינטגרציה עם n8n.
ייבוא תהליך העבודה
הורידו תבנית מהטבלה שלמטה. ב-n8n, צרו תהליך עבודה וייבאו את הקובץ (התפריט … ← Import from File, או הדביקו את ה-JSON על הקנבס).
הוספת ה-credentials
פתחו את הצומת WbizTool Send Message ובחרו או צרו credential מסוג WbizTool API. בתהליך הקבלה, פתחו את הצומת HighLevel ובחרו או צרו credential של HighLevel.
חיבור ה-Webhook
העתיקו את כתובת ה-production של הצומת Webhook. שליחה: השתמשו בה כ-URL של פעולת Webhook ב-HighLevel, עם מפתח ה-Custom Data
phone_rawשמוגדר ל-{{contact.phone_raw}}. קבלה: הדביקו אותה ככתובת ה-Webhook של המספר בדף מספרים בתיבת ההודעות, כשרק הודעות שהתקבלו מסומן.הפעלה
הפעילו את תהליך העבודה והריצו בדיקה.
Pabbly Connect#
השתמשו בטריגר ה-Webhook של Pabbly Connect ובפעולה API (Pabbly) שלו, כמו שמוסבר בשליחת הודעות WhatsApp מכל כלי אוטומציה. בכיוון השליחה, הפנו פעולת Webhook של HighLevel לכתובת ה-Webhook של Pabbly ומפו את phone_raw ל-phone. להודעות נכנסות, הדביקו את כתובת ה-Webhook של Pabbly ככתובת ה-Webhook של המספר בדף מספרים בתיבת ההודעות.
תבניות#
| קובץ | מה הוא עושה |
|---|---|
| ghl-blocks.md | הבלוקים להעתקה והדבקה מהדף הזה, בקובץ אחד. |
| gohighlevel-to-whatsapp.make.json | Make: Webhook של HighLevel ← הודעת WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: הודעת WhatsApp נכנסת ← איש קשר והערה ב-HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: Webhook של HighLevel ← הודעת WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: הודעת WhatsApp נכנסת ← איש קשר ב-HighLevel עם הערה. |
בתבניות אין מפתחות. אחרי הייבוא, הוסיפו את המפתחות שלכם ב-placeholders או ב-credentials.
פתרון בעיות#
| בעיה | מה לעשות |
|---|---|
ההודעה מגיעה למספר הלא נכון, או Invalid phone number | השתמשו ב-{{contact.phone_raw}}, לא ב-{{contact.phone}}. אם למספר של איש הקשר אין קידומת מדינה ב-HighLevel, הוסיפו country_code לגוף או תקנו את איש הקשר. |
Either phone or group_name parameter is required | לאיש הקשר אין מספר טלפון. הוסיפו שלב If/Else לפני הפעולה. |
Auth Error: invalid api key | בדקו את הכותרת Authorization: Bearer, רווח, ואז המפתח, בלי מירכאות. ייתכן שהמפתח נמחק. ראו מפתחות API. |
Invalid whatsapp client או Invalid whatsapp client id. | השתמשו ב-WhatsApp Client ID מהדף מספרי WhatsApp. הוא חובה כשיש לכם יותר ממספר אחד. |
Invalid JSON format: … | הגוף אינו JSON תקין: חסר פסיק, יש פסיק מיותר בסוף, יש ירידת שורה אמיתית ב-msg, או שערך ממוזג מכיל מירכאות כפולות. |
"status": 1, אבל שום דבר לא מגיע | ההודעה ממתינה בתור עד שמספר ה-WhatsApp שלכם מחובר. בדקו את מספרי WhatsApp ואת סטטוס הודעה. |
| הפעולה Custom Webhook או Inbound Webhook חסרה | הסוכנות לא הפעילה את יכולות ה-premium של תהליכי העבודה (Workflow - Premium Features), או שתת-החשבון ניצל את ההרצות החינמיות שלו ולא מחויב עליהן. פנו לסוכנות שלכם. |
| הודעות נכנסות לא מגיעות ל-HighLevel | המספר חייב להיות במצב מסתנכרן בדף מספרים בתיבת ההודעות, עם הכתובת הנכונה וכש-הודעות שהתקבלו מסומן. הצד המקבל חייב לענות ב-2xx תוך 8 שניות. הבקשות מגיעות עם ה-User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), למקרה שחומת אש מסננת לפיו. עוד פרטים בWebhooks להודעות נכנסות. |
| נדרש תוסף Unibox | הודעות נכנסות דורשות את תוסף Unibox בתוכנית בתשלום או בתוכנית לכל החיים. ראו חבילות וחיוב. |
| לכל הודעה נוצר איש קשר חדש | מפו את Phone עם + בהתחלה, כדי ש-HighLevel תתאים אותו לאיש הקשר הקיים. |
| צ׳אטים קבוצתיים יוצרים אנשי קשר מוזרים | דלגו בשלב If/Else על הודעות שבהן contact.is_group הוא true. |
| ההודעות הנכנסות הפסיקו אחרי שהופעל Zap | Zap עם הטריגר Incoming WhatsApp Message של WbizTool משתלט על ה-Webhook של המספר כל עוד הוא פועל. כבו את ה-Zap, או השתמשו במספר אחר. |
מדריכים קשורים#
- API לשליחת הודעה: כל שדה וכל שגיאה
- Webhooks להודעות נכנסות: מספרים בתיבת ההודעות, מסירה, מטען
- מפתחות API ו-Client ID
- אינטגרציה עם Zapier
- אינטגרציה עם n8n
- שליחה מכל כלי אוטומציה: Make, Pabbly Connect ואחרים

