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

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

> משתמשים ב-CRM אחר? אין צורך במסך ייעודי כדי לעבוד עם <span data-t="appName">Your AI Connector</span>: ראו [חיבור כלי שאינו מופיע ברשימה שלנו](connecting-other-tools.md) עבור פונקציות מותאמות אישית, ה-API ו-webhooks.

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

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


---

## דרישות קדם

- **חשבון <span data-t="appName">Your AI Connector</span>** פעיל עם מפתח ה-API שלכם (נמצא תחת **Settings → Integrations → API Key**). מפתח API הוא קוד ייחודי המאפשר ל-GHL לתקשר בצורה מאובטחת עם החשבון שלכם.
- **חשבון GoHighLevel** עם הרשאות ליצירת תהליכי עבודה (workflows) וניהול Webhooks (התראות אוטומטיות בין מערכות).

---

## איך זה עובד

| כיוון | מה קורה |
|---|---|
| **GHL ל-<span data-t="appName">Your AI Connector</span>** | לקוח שולח לכם הודעה ב-SMS, אימייל, Messenger, אינסטגרם או צ'אט חי ב-GHL. תהליך עבודה מעביר את ההודעה באופן אוטומטי ל-<span data-t="appName">Your AI Connector</span>. <span data-t="appName">Your AI Connector</span> מעבדת אותה (תגובת AI, תיוג וכו'). |
| **<span data-t="appName">Your AI Connector</span> ל-GHL** | כאשר <span data-t="appName">Your AI Connector</span> שולחת תשובה (ידנית או באמצעות AI), היא מעדכנת את GHL באופן אוטומטי. תהליך עבודה ב-GHL מאתר את איש הקשר ושולח את התשובה דרך הערוץ הנכון. |

---

## תהליך עבודה 1: GHL ל-<span data-t="appName">Your AI Connector</span>

תהליך עבודה זה מעביר הודעות נכנסות מ-GHL ל-<span data-t="appName">Your AI Connector</span>.

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

1. ב-GHL, עברו אל **Automation > Workflows**.
2. לחצו על **Create New Workflow**.
3. תנו לו שם תיאורי, כגון "Send Message to <span data-t="appName">Your AI Connector</span>."

### שלב 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` |

::: warning
**חשוב:** ודאו שערך ה-`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 בכל פעם שנשלחת הודעה לאיש קשר. הנתונים שנשלחים נראים כך:

```json
{
  "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](webhooks.md) אם זה מה שאתה מחפש במקום זאת.

### שלב 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 ל-<span data-t="appName">Your AI Connector</span> (תהליך עבודה 1)

1. שלחו הודעה למספר ה-GHL שלכם או לערוץ מחובר (לדוגמה, שלחו לעצמכם הודעת SMS).
2. פתחו את <span data-t="appName">Your AI Connector</span> וודאו שההודעה מופיעה ב-**Chats**.
3. בדקו שתווית הערוץ נכונה (SMS, אימייל וכו').
4. חזרו על הפעולה עבור כל ערוץ שהגדרתם.

### בדיקת <span data-t="appName">Your AI Connector</span> ל-GHL (תהליך עבודה 2)

1. ב-<span data-t="appName">Your AI Connector</span>, שלח תשובה לאיש קשר (ידנית או תן ל-AI להשיב).
2. פתח את GHL וודא שאיש הקשר קיבל את ההודעה.
3. אשר שהיא נשלחה דרך הערוץ הנכון.
4. בדוק שתוכן ההודעה תואם.

---

## פתרון בעיות

| בעיה | מה לבדוק |
|---|---|
| הודעות לא מגיעות ל-<span data-t="appName">Your AI Connector</span> | ודא שמפתח ה-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.md) — הגדר webhooks עבור אירועי <span data-t="appName">Your AI Connector</span> אחרים.
- [API Access](api-access.md) — השתמש ב-API עבור אינטגרציות מותאמות אישית מעבר ל-GHL.
- [Custom Channels](../messaging-channels/custom-channels.md) — למד עוד על הודעות בערוצים מותאמים אישית.