# تكامل GoHighLevel (GHL)

هل تستخدم بالفعل GoHighLevel (GHL) لإدارة عملك؟ يتيح لك هذا التكامل إضافة ميزات المراسلة المدعومة بالذكاء الاصطناعي من <span data-t="appName">Your AI Connector</span> إلى إعدادات GHL الحالية لديك. يتم توجيه الرسائل التي تصل إلى GHL إلى <span data-t="appName">Your AI Connector</span> للمعالجة بواسطة الذكاء الاصطناعي، ويتم إرسال الردود من <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 كمركز رئيسي لك مع السماح للذكاء الاصطناعي بالتعامل مع المحادثات الموجهة بالذكاء الاصطناعي.

::: note
**ملاحظة:** هذا تكامل تقني يتضمن إعداد سير عمل مؤتمت وربط الأنظمة باستخدام خطافات الويب (webhooks) (إشعارات تلقائية بين التطبيقات) واستدعاءات واجهة برمجة التطبيقات (API). إذا لم تكن مرتاحاً للقيام بذلك، فقد ترغب في إحالة هذه الصفحة إلى مطور أو أحد أعضاء فريقك المتمكنين تقنياً.
:::


---

## المتطلبات الأساسية

- **حساب <span data-t="appName">Your AI Connector</span>** نشط مع مفتاح API الخاص بك (الموجود في **الإعدادات ← عمليات التكامل ← مفتاح API**). مفتاح API هو رمز فريد يسمح لـ GHL بالتواصل بشكل آمن مع حسابك.
- **حساب GoHighLevel** مع صلاحية إنشاء سير العمل (workflows) وإدارة خطافات الويب (webhooks) (إشعارات آلية بين الأنظمة).

---

## كيف يعمل

| الاتجاه | ماذا يحدث |
|---|---|
| **من GHL إلى <span data-t="appName">Your AI Connector</span>** | يرسل لك عميل رسالة عبر الرسائل القصيرة (SMS) أو البريد الإلكتروني أو Messenger أو Instagram أو الدردشة المباشرة في GHL. يقوم سير العمل تلقائيًا بتوجيه تلك الرسالة إلى <span data-t="appName">Your AI Connector</span>. يقوم <span data-t="appName">Your AI Connector</span> بمعالجتها (رد الذكاء الاصطناعي، وضع العلامات، إلخ). |
| **من <span data-t="appName">Your AI Connector</span> إلى GHL** | عندما يرسل <span data-t="appName">Your AI Connector</span> ردًا (يدويًا أو عبر الذكاء الاصطناعي)، فإنه يخطر 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. امنحه اسمًا وصفيًا، مثل "إرسال رسالة إلى <span data-t="appName">Your AI Connector</span>".

### الخطوة 2: إضافة المشغلات

أضف مشغلاً لكل قناة تريد توجيهها:

- رد العميل - الرسائل القصيرة (SMS)
- رد العميل - البريد الإلكتروني
- رد العميل - رسالة فيسبوك
- رد العميل - رسالة إنستغرام المباشرة (DM)
- رد العميل - الدردشة المباشرة

يمكنك إضافة جميع هذه القنوات أو فقط القنوات ذات الصلة بإعدادك.

### الخطوة 3: إضافة عامل تصفية العلامات (اختياري)

إذا كنت ترغب فقط في إعادة توجيه الرسائل من جهات اتصال محددة:

1. انقر على **إضافة عامل تصفية (Add Filter)** في المشغل.
2. اضبط الشرط على "جهة الاتصال لديها وسم (Contact has tag)".
3. اختر الوسم (الأوسمة) الخاص بك.
4. حدد ما إذا كان يجب أن تحتوي جهة الاتصال على **أي (any)** أو **كل (all)** الأوسمة المحددة.

### الخطوة 4: إنشاء تقسيم للقنوات

أضف إجراء **شرط (Condition)** لتوجيه كل قناة إلى خطاف الويب (webhook) الخاص بها:

| الفرع | الشرط |
|---|---|
| الفرع 1 | مصدر الرسالة يساوي `Email` |
| الفرع 2 | مصدر الرسالة يساوي `SMS` |
| الفرع 3 | مصدر الرسالة يساوي `Messenger` |
| الفرع 4 | مصدر الرسالة يساوي `Instagram` |
| الفرع 5 | مصدر الرسالة يساوي `Live Chat` |

### الخطوة 5: تكوين خطافات الويب (Webhooks)

لكل فرع، أضف إجراء **خطاف ويب / طلب HTTP (Webhook / HTTP Request)**:

- **الطريقة (Method):** `POST`
- **URL:**
  ```
  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  ```

- **حقول البيانات المخصصة (Custom Data fields):**

| الحقل | القيمة | ملاحظات |
|---|---|---|
| `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` |
| إنستغرام | `ig` |
| الدردشة المباشرة | `livechat` |

::: warning
**هام:** تأكد من أن قيمة `channel` تطابق تماماً — فهذه القيم حساسة لحالة الأحرف.
:::


### الخطوة 6: تمكين إعادة الدخول

في إعدادات سير العمل، تأكد من تمكين **السماح بإعادة الدخول (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** وانسخه — ستحتاج إليه في الخطوة التالية.

### الخطوة 2: تهيئة Your AI Connector

1. في Your AI Connector، انقر على **Settings** (الإعدادات) في الشريط الجانبي.
2. ضمن **Channels** (القنوات)، انقر على **Channels** (القنوات).
3. مرر للأسفل إلى بطاقة **Custom channel** (قناة مخصصة) في أسفل الصفحة تماماً.
4. الصق رابط 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، انتقل إلى **الأتمتة > سير العمل**.
2. أنشئ سير عمل جديدًا باسم "إرسال رسالة إلى جهة اتصال".
3. اضبط المشغل على **خطاف ويب وارد (Inbound Webhook)** وحدد خطاف الويب الذي أنشأته في الخطوة 1.

### الخطوة 4: إضافة إجراء البحث عن جهة اتصال

1. أضف إجراء **البحث عن جهة اتصال (Find Contact)**.
2. اضبط حقل البحث على **معرف جهة الاتصال (Contact ID)**.
3. استخدم القيمة: `{{inboundWebhookRequest.toId}}`

### الخطوة 5: إضافة فحص اختياري للوسم (Tag)

إذا كنت ترغب في تحديد جهات الاتصال التي تتلقى رسائل من Your AI Connector:

1. أضف إجراء **شرط (Condition)**.
2. تحقق مما إذا كانت جهة الاتصال تحتوي على وسم معين.
3. إذا كان الوسم مفقودًا، قم بإنهاء سير العمل (أضف إجراء "إيقاف" في الفرع الخاطئ).

### الخطوة 6: إضافة تقسيم القناة

أضف إجراء **شرط (Condition)** يوجه الرسالة بناءً على `{{inboundWebhookRequest.channel}}`:

| الفرع | الشرط | الإجراء |
|---|---|---|
| الفرع 1 | يساوي `email` | إرسال بريد إلكتروني |
| الفرع 2 | يساوي `sms` | إرسال رسالة نصية (SMS) |
| الفرع 3 | يساوي `messenger` | إرسال رسالة فيسبوك |
| الفرع 4 | يساوي `ig` | إرسال رسالة إنستغرام |
| الفرع 5 | يساوي `livechat` | إرسال رسالة دردشة |

### الخطوة 7: تكوين كل إجراء إرسال

في كل إجراء إرسال، اضبط نص الرسالة على:

```
{{inboundWebhookRequest.body}}
```

### الخطوة 8: تمكين إعادة الدخول

كما هو الحال مع سير العمل 1، تأكد من تمكين **السماح بإعادة الدخول (Allow Re-entry)** في إعدادات سير العمل.

---

## اختبار التكامل

### اختبار من GHL إلى <span data-t="appName">Your AI Connector</span> (سير العمل 1)

1. أرسل رسالة إلى رقم GHL الخاص بك أو القناة المتصلة (على سبيل المثال، أرسل رسالة نصية قصيرة لنفسك).
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>، أرسل رداً إلى جهة اتصال (يدوياً أو اترك الذكاء الاصطناعي يستجيب).
2. افتح GHL وتحقق من أن جهة الاتصال قد تلقت الرسالة.
3. تأكد من إرسالها عبر القناة الصحيحة.
4. تحقق من تطابق محتوى الرسالة.

---

## استكشاف الأخطاء وإصلاحها

| المشكلة | ما يجب التحقق منه |
|---|---|
| الرسائل لا تصل إلى <span data-t="appName">Your AI Connector</span> | تحقق من صحة مفتاح API الخاص بك في رابط webhook. تأكد من أن مشغلات سير العمل (workflow triggers) تعمل (سجلات سير عمل GHL). تأكد من تمكين خيار السماح بإعادة الدخول (Allow Re-entry). |
| الرسائل لا تصل إلى GHL | تحقق من لصق رابط webhook الوارد الخاص بـ GHL بشكل صحيح في **Webhook URL** على بطاقة **Custom channel** في أسفل **Settings → Channels** (وليس في صفحة Settings → Integrations → Webhooks، فهي ميزة مختلفة). تحقق من أن webhook الوارد الخاص بـ GHL نشط. راجع سجلات تنفيذ سير عمل GHL. |
| جهة الاتصال غير موجودة في GHL | يجب أن يطابق `toId` في بيانات webhook معرف جهة اتصال GHL موجود. تأكد من وجود جهات الاتصال في كلا النظامين بمعرفات متطابقة. |
| تم استخدام قناة خاطئة للرد | تحقق جيداً من قيم القناة في فروع الشروط الخاصة بك. يجب أن تتطابق تماماً: `email`، `sms`، `messenger`، `ig`، `livechat`. |
| يتم إعادة توجيه الرسالة الأولى فقط | قم بتمكين **Allow Re-entry** (السماح بإعادة الدخول) في إعدادات سير العمل كلاهما. |

---

## الخطوات التالية

- [Webhooks](webhooks.md) — إعداد webhooks لأحداث <span data-t="appName">Your AI Connector</span> أخرى.
- [الوصول إلى API](api-access.md) — استخدم API لعمليات التكامل المخصصة بخلاف GHL.
- [القنوات المخصصة](../messaging-channels/custom-channels.md) — تعرف على المزيد حول مراسلة القنوات المخصصة.