Your AI Connector Docs

אינטגרציית GoHighLevel (GHL)

כבר משתמשים ב-GoHighLevel (GHL) כדי לנהל את העסק שלכם? אינטגרציה זו מאפשרת לכם להוסיף את ההודעות מבוססות ה-AI של Your AI Connector על גבי הגדרות ה-GHL הקיימות שלכם. הודעות שמגיעות ל-GHL מועברות ל-Your AI Connector לצורך טיפול מבוסס AI, ותשובות מ-Your AI Connector נשלחות בחזרה דרך GHL ללקוח בערוץ המקורי.

משתמשים ב-CRM אחר? אין צורך במסך ייעודי כדי לעבוד עם Your AI Connector: ראו חיבור כלי שאינו מופיע ברשימה שלנו עבור פונקציות מותאמות אישית, ה-API ו-webhooks.

משמעות הדבר היא שתוכל להמשיך להשתמש ב-GHL כמרכז הראשי שלך, תוך מתן אפשרות ל-AI לנהל את השיחות המונעות על ידי בינה מלאכותית.

הערה: מדובר באינטגרציה טכנית יותר הכוללת הגדרת תהליכי עבודה (workflows) אוטומטיים וחיבור מערכות באמצעות Webhooks (התראות אוטומטיות בין אפליקציות) וקריאות API. אם אינכם מרגישים בנוח עם זה, ייתכן שתרצו להעביר דף זה למפתח או לחבר צוות בעל ידע טכני.


דרישות קדם

  • חשבון Your AI Connector פעיל עם מפתח ה-API שלכם (נמצא תחת Settings → Integrations → API Key). מפתח API הוא קוד ייחודי המאפשר ל-GHL לתקשר בצורה מאובטחת עם החשבון שלכם.
  • חשבון GoHighLevel עם הרשאות ליצירת תהליכי עבודה (workflows) וניהול Webhooks (התראות אוטומטיות בין מערכות).

איך זה עובד

כיוון מה קורה
GHL ל-Your AI Connector לקוח שולח לכם הודעה ב-SMS, אימייל, Messenger, אינסטגרם או צ’אט חי ב-GHL. תהליך עבודה מעביר את ההודעה באופן אוטומטי ל-Your AI Connector. Your AI Connector מעבדת אותה (תגובת AI, תיוג וכו’).
Your AI Connector ל-GHL כאשר Your AI Connector שולחת תשובה (ידנית או באמצעות AI), היא מעדכנת את GHL באופן אוטומטי. תהליך עבודה ב-GHL מאתר את איש הקשר ושולח את התשובה דרך הערוץ הנכון.

תהליך עבודה 1: GHL ל-Your AI Connector

תהליך עבודה זה מעביר הודעות נכנסות מ-GHL ל-Your AI Connector.

שלב 1: יצירת תהליך העבודה

  1. ב-GHL, עברו אל Automation > Workflows.
  2. לחצו על Create New Workflow.
  3. תנו לו שם תיאורי, כגון “Send Message to Your AI Connector.”

שלב 2: הוספת טריגרים

הוסף טריגר עבור כל ערוץ שברצונך להעביר:

  • Customer Replied - SMS
  • Customer Replied - Email
  • Customer Replied - Facebook Message
  • Customer Replied - Instagram DM
  • Customer Replied - Live Chat

ניתן להוסיף את כולם או רק את הערוצים הרלוונטיים להגדרה שלך.

שלב 3: הוספת מסנן תגיות (אופציונלי)

אם ברצונך להעביר הודעות מאנשי קשר ספציפיים בלבד:

  1. לחץ על הוסף מסנן (Add Filter) בטריגר.
  2. הגדר את התנאי ל-“Contact has tag” (לאיש הקשר יש תגית).
  3. בחר את התגית/תגיות שלך.
  4. בחר אם על איש הקשר להחזיק בכל או באחת מהתגיות שנבחרו.

שלב 4: יצירת פיצול ערוצים

הוסף פעולת תנאי (Condition) כדי לנתב כל ערוץ ל-webhook משלו:

ענף תנאי
ענף 1 מקור ההודעה שווה ל-Email
ענף 2 מקור ההודעה שווה ל-SMS
ענף 3 מקור ההודעה שווה ל-Messenger
ענף 4 מקור ההודעה שווה ל-Instagram
ענף 5 מקור ההודעה שווה ל-Live Chat

שלב 5: הגדרת Webhooks

עבור כל ענף, הוסף פעולת Webhook / HTTP Request:

  • שיטה: POST

  • URL:

    https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • שדות נתונים מותאמים אישית:

שדה ערך הערות
messageSid {{right_now.second}}{{contact.id}} מזהה הודעה ייחודי
fromId {{contact.id}} מזהה איש קשר ב-GHL
toId {{user.id}} מזהה משתמש GHL שלך
body {{message.body}} תוכן ההודעה
channel ראה טבלה למטה חייב להתאים לענף
status created תמיד מוגדר ל-created
messageType text סוג הודעה

ערכי ערוץ לפי ענף:

ענף ערך channel
דוא"ל email
SMS sms
Messenger messenger
Instagram ig
צ’אט חי livechat

חשוב: ודאו שערך ה-channel תואם במדויק — הם רגישים לאותיות גדולות/קטנות (case-sensitive).

שלב 6: הפעלת כניסה מחדש

בהגדרות זרימת העבודה (workflow), ודא שהאפשרות אפשר כניסה מחדש (Allow Re-entry) מופעלת. ללא הגדרה זו, רק ההודעה הראשונה מכל איש קשר תועבר.


תהליך עבודה 2: Your AI Connector ל-GHL

תהליך עבודה זה מקבל תשובות מ-Your AI Connector ושולח אותן ללקוח דרך ערוץ ה-GHL הנכון.

שלב 1: יצירת Webhook נכנס ב-GHL

  1. ב-GHL, עברו אל Settings > Developers / API.
  2. לחצו על Create New Webhook (או “Inbound Webhook”).
  3. תנו לו את השם “Messages.”
  4. שמרו והעתיקו את כתובת ה-webhook URL — תזדקקו לה בשלב הבא.

שלב 2: הגדרת Your AI Connector

  1. ב-Your AI Connector, לחץ על Settings (הגדרות) בסרגל הצד.
  2. תחת Channels (ערוצים), לחץ על Channels.
  3. גלול אל הכרטיס Custom channel (ערוץ מותאם אישית) בתחתית העמוד.
  4. הדבק את כתובת ה-URL של ה-webhook הנכנס של GHL שהעתקת זה עתה לתוך Webhook URL (חייבת להיות כתובת HTTPS ציבורית) ולחץ על Save (שמירה).

זהו אינו דף ה-Settings → Integrations → Webhooks. דף זה מיועד להתראות אירועים ושולח מטען (payload) שונה. הממסר היוצא של GHL מוגדר בכרטיס Custom channel תחת Settings → Channels.

Your AI Connector תשלח כעת באופן אוטומטי התראה ל-GHL בכל פעם שנשלחת הודעה לאיש קשר. הנתונים שנשלחים נראים כך:

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

הערת ניווט: מפתח ה-API שבו אתה משתמש עבור Workflow 1 וכרטיס ה-Custom channel שבו אתה משתמש כאן נמצאים במקומות שונים — Settings → Integrations → API Key עבור המפתח, וכרטיס ה-Custom channel בתחתית Settings → Channels עבור ממסר זה. דף ה-Settings → Integrations → Webhooks הנפרד מיועד להתראות אירועים ושולח מטען שונה; עיין ב-Webhooks אם זה מה שאתה מחפש במקום זאת.

שלב 3: יצירת תהליך עבודה לתגובה

  1. ב-GHL, עברו אל Automation > Workflows.
  2. צרו תהליך עבודה חדש בשם “Send Message to Contact.”
  3. הגדירו את הטריגר ל-Inbound Webhook ובחרו ב-webhook שיצרתם בשלב 1.

שלב 4: הוספת פעולת מציאת איש קשר (Find Contact)

  1. הוסיפו פעולת Find Contact.
  2. הגדירו את שדה החיפוש ל-Contact ID.
  3. השתמשו בערך: {{inboundWebhookRequest.toId}}

שלב 5: הוספת בדיקת תגית אופציונלית

אם ברצונכם להגביל אילו אנשי קשר יקבלו הודעות מ-Your AI Connector:

  1. הוסיפו פעולת Condition.
  2. בדקו אם לאיש הקשר יש תגית ספציפית.
  3. אם התגית חסרה, סיימו את תהליך העבודה (הוסיפו פעולת “Stop” בענף השלילי).

שלב 6: הוספת פיצול ערוצים

הוסף פעולת Condition (תנאי) שמנתבת את ההודעה בהתבסס על {{inboundWebhookRequest.channel}}:

ענף תנאי פעולה
ענף 1 שווה ל-email שלח אימייל
ענף 2 שווה ל-sms שלח SMS
ענף 3 שווה ל-messenger שלח הודעת פייסבוק
ענף 4 שווה ל-ig שלח הודעת אינסטגרם
ענף 5 שווה ל-livechat שלח הודעת צ’אט

שלב 7: הגדרת כל פעולת שליחה

בכל פעולת שליחה, הגדר את גוף ההודעה ל:

{{inboundWebhookRequest.body}}

שלב 8: הפעלת כניסה מחדש (Re-Entry)

כמו ב-Workflow 1, ודא שהאפשרות Allow Re-entry מופעלת בהגדרות זרימת העבודה.


בדיקת האינטגרציה

בדיקת GHL ל-Your AI Connector (תהליך עבודה 1)

  1. שלחו הודעה למספר ה-GHL שלכם או לערוץ מחובר (לדוגמה, שלחו לעצמכם הודעת SMS).
  2. פתחו את Your AI Connector וודאו שההודעה מופיעה ב-Chats.
  3. בדקו שתווית הערוץ נכונה (SMS, אימייל וכו’).
  4. חזרו על הפעולה עבור כל ערוץ שהגדרתם.

בדיקת Your AI Connector ל-GHL (תהליך עבודה 2)

  1. ב-Your AI Connector, שלח תשובה לאיש קשר (ידנית או תן ל-AI להשיב).
  2. פתח את GHL וודא שאיש הקשר קיבל את ההודעה.
  3. אשר שהיא נשלחה דרך הערוץ הנכון.
  4. בדוק שתוכן ההודעה תואם.

פתרון בעיות

בעיה מה לבדוק
הודעות לא מגיעות ל-Your AI Connector ודא שמפתח ה-API שלך נכון בכתובת ה-webhook. בדוק אם מפעיל ה-workflow פועל (יומני ה-workflow של GHL). אשר ש-Allow Re-entry (אפשר כניסה מחדש) מופעל.
הודעות לא מגיעות ל-GHL ודא שכתובת ה-webhook הנכנס של GHL מודבקת כראוי ב-Webhook URL בכרטיס Custom channel בתחתית Settings → Channels (לא בדף Settings → Integrations → Webhooks, שהוא תכונה שונה). בדוק שה-webhook הנכנס של GHL פעיל. עיין ביומני הביצוע של ה-workflow ב-GHL.
איש קשר לא נמצא ב-GHL ה-toId בנתוני ה-webhook חייב להתאים למזהה איש קשר קיים ב-GHL. ודא שאנשי קשר קיימים בשתי המערכות עם מזהים תואמים.
נעשה שימוש בערוץ שגוי עבור תשובה בדוק שוב את ערכי הערוץ בענפי התנאי שלך. הם חייבים להתאים בדיוק: email, sms, messenger, ig, livechat.
רק ההודעה הראשונה מועברת הפעל את Allow Re-entry (אפשר כניסה מחדש) בשתי הגדרות ה-workflow.

צעדים הבאים

  • Webhooks — הגדר webhooks עבור אירועי Your AI Connector אחרים.
  • API Access — השתמש ב-API עבור אינטגרציות מותאמות אישית מעבר ל-GHL.
  • Custom Channels — למד עוד על הודעות בערוצים מותאמים אישית.