דלגו לתוכן
WbizTool

אינטגרציות

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 ‏← מודול HTTPWebhook של WbizTool ‏← Webhooks של Make ‏← ה-API של HighLevelחשבון Make. קבלה: תוסף Unibox.
n8nפעולת Webhook של HighLevel ‏← Webhook של n8n ‏← WbizTool Send MessageWebhook של 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#

  1. פתיחה או יצירה של תהליך עבודה

    בתת-החשבון שלכם ב-HighLevel, פתחו את Automation (אוטומציה) וצרו תהליך עבודה (workflow), או ערכו תהליך קיים. תנו לו את הטריגר הרצוי, למשל שליחת טופס, תג חדש או פגישה שנקבעה.

  2. הוספת הפעולה Custom Webhook

    לחצו על + במקום שבו ההודעה צריכה לצאת, ואז על Send Data → Custom Webhook (או חפשו בפעולות "webhook" ובחרו Custom Webhook). הפעולה הפשוטה Webhook לא יכולה להגדיר את הכותרת והגוף שה-API הזה צריך.

  3. הגדרת הבקשה

    הגדירו את 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.

  4. הדבקת הגוף

    הדביקו את אחד מהבלוקים להעתקה והדבקה ב-Raw Body והחליפו את 678 ב-WhatsApp Client ID שלכם. השתמשו בסמל התג של HighLevel כדי להוסיף להודעה עוד שדות של איש הקשר.

  5. בדיקה ופרסום

    שמרו את הפעולה ופרסמו את תהליך העבודה. הריצו אותו על איש קשר לבדיקה עם מספר הטלפון שלכם. כל הרצה מופיעה ביומני ההרצה (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

Raw Body לפעולה Custom Webhook
{
  "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: המזהה של המספר שממנו שולחים. אפשר להשמיט אותו רק כשבסביבת העבודה שלכם יש בדיוק מספר מחובר אחד.
  • 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.

  1. יצירת תהליך עבודה עם טריגר Inbound Webhook

    ב-HighLevel, צרו תהליך עבודה ובחרו את הטריגר Inbound Webhook. העתיקו את כתובת ה-Webhook שהוא מציג.

  2. הפניית מספר ה-WhatsApp שלכם אליו

    ב-WbizTool, פתחו את מספרים בתיבת ההודעות. לחצו על הוספת מספר לתיבת ההודעות, בחרו את המספר והדביקו את הכתובת מ-HighLevel תחת כתובת URL של ה-Webhook (לא חובה). למספר שכבר נמצא בתיבת ההודעות, הדביקו אותה בהגדרות Webhook של המספר. תחת הודעות לשליחה, סמנו רק את הודעות שהתקבלו. כל שליחה היא הרצת premium אחת ב-HighLevel, לכן השאירו את הודעות שנשלחו כבוי אלא אם אתם צריכים אותן.

  3. שליחת הודעת בדיקה

    מטלפון אחר, שלחו הודעה למספר ה-WhatsApp שלכם. היא נשלחת אחרי הבדיקה הבאה, בדרך כלל תוך דקה או שתיים. ב-HighLevel, לחצו על Test Trigger, בחרו את הבקשה תחת Mapping Reference ושמרו את הטריגר. השדות מפורטים במטען ה-Webhook.

  4. דילוג על קבוצות ועל מספרים מוסתרים

    הוסיפו שלב If/Else שממשיך רק כש-event הוא message_received, ‏contact.is_group הוא false ו-contact.phone לא ריק. לפעמים WhatsApp מסתירה את המספר של השולח, והודעות בקבוצות נושאות את מזהה הקבוצה במקום מספר טלפון.

  5. מציאה או יצירה של איש הקשר

    בפעולה Create/Update Contact, הגדירו את Phone ל-+ ואחריו contact → phone מתוך הערכים של ה-Inbound Webhook. ‏WbizTool שולחת את המספר בלי +, וה-+ אומר ל-HighLevel שהמספר כולל את קידומת המדינה. אפשר גם למפות את contact → name. זה שם ה-WhatsApp של השולח, והוא עלול להחליף שם שערכתם ב-HighLevel.

  6. הוספת ההודעה לאיש הקשר

    הוסיפו פעולה Add to Notes. כתבו הערה כמו "הודעת WhatsApp:" ובחרו message → content ו-message → timestamp מתוך הערכים של ה-Inbound Webhook. אפשר גם להוסיף Add Contact Tag (למשל whatsapp), משימה או התראה פנימית לצוות.

  7. פרסום

    פרסמו את תהליך העבודה ושלחו עוד הודעת בדיקה.

ערך של Inbound Webhookלמה הוא משמש
contact.phoneהטלפון של איש הקשר. הוסיפו + בהתחלה.
contact.nameשם ה-WhatsApp של השולח. יכול להיות ריק.
message.contentהטקסט. לתמונות, הודעות קוליות וקבצים זו תווית כמו 📸 Image, והכיתובים לא נכללים.
message.timestampמתי ההודעה נשלחה ב-WhatsApp ‏(ISO 8601, ‏UTC).
message.media.urlקישור להורדת תמונה או קובץ. תוקפו פג אחרי 3½ עד 7 ימים, לכן אל תסתמכו עליו בהערה.
whatsapp_phoneאיזה מהמספרים שלכם קיבל אותה, אם כמה מספרים שולחים לאותו תהליך עבודה.
eventmessage_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 שלכם (ראו בהמשך).

  1. ייבוא ה-blueprint

    הורידו תבנית מהטבלה שלמטה. ב-Make, צרו תרחיש (scenario), פתחו את התפריט … ובחרו Import blueprint.

  2. יצירת ה-Webhook

    פתחו את המודול Webhooks, לחצו על Add כדי ליצור Webhook והעתיקו את הכתובת שלו.

  3. מילוי ה-placeholders

    החליפו כל placeholder באותיות גדולות במודולי ה-HTTP, כמו YOUR_WBIZTOOL_API_KEY ו-YOUR_WHATSAPP_CLIENT_ID.

  4. חיבור ה-Webhook

    שליחה: ב-HighLevel, הוסיפו לתהליך העבודה פעולת Webhook עם הכתובת של Make כ-URL שלה. תחת Custom Data, הוסיפו את המפתח phone_raw עם הערך {{contact.phone_raw}}. קבלה: הדביקו את הכתובת של Make ככתובת ה-Webhook של המספר בדף מספרים בתיבת ההודעות, כשרק הודעות שהתקבלו מסומן.

  5. הרצה אחת

    לחצו על 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.

  1. ייבוא תהליך העבודה

    הורידו תבנית מהטבלה שלמטה. ב-n8n, צרו תהליך עבודה וייבאו את הקובץ (התפריט … ‏← Import from File, או הדביקו את ה-JSON על הקנבס).

  2. הוספת ה-credentials

    פתחו את הצומת WbizTool Send Message ובחרו או צרו credential מסוג WbizTool API. בתהליך הקבלה, פתחו את הצומת HighLevel ובחרו או צרו credential של HighLevel.

  3. חיבור ה-Webhook

    העתיקו את כתובת ה-production של הצומת Webhook. שליחה: השתמשו בה כ-URL של פעולת Webhook ב-HighLevel, עם מפתח ה-Custom Data ‏phone_raw שמוגדר ל-{{contact.phone_raw}}. קבלה: הדביקו אותה ככתובת ה-Webhook של המספר בדף מספרים בתיבת ההודעות, כשרק הודעות שהתקבלו מסומן.

  4. הפעלה

    הפעילו את תהליך העבודה והריצו בדיקה.

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, או השתמשו במספר אחר.

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