تكامل GoHighLevel (GHL) #

هل تستخدم بالفعل GoHighLevel (GHL) لإدارة عملك؟ يتيح لك هذا التكامل إضافة ميزات المراسلة المدعومة بالذكاء الاصطناعي من Your AI Connector إلى إعدادات GHL الحالية لديك. يتم توجيه الرسائل التي تصل إلى GHL إلى Your AI Connector للمعالجة بواسطة الذكاء الاصطناعي، ويتم إرسال الردود من Your AI Connector مرة أخرى عبر GHL إلى العميل على القناة الأصلية.

هل تستخدم نظام CRM مختلفاً؟ لا يحتاج الأمر إلى شاشة مخصصة للعمل مع Your AI Connector: راجع ربط أداة غير مدرجة في قائمتنا للاطلاع على الوظائف المخصصة، وواجهة برمجة التطبيقات (API)، وخطافات الويب (webhooks).

هذا يعني أنه يمكنك الاستمرار في استخدام GHL كمركز رئيسي لك مع السماح للذكاء الاصطناعي بالتعامل مع المحادثات الموجهة بالذكاء الاصطناعي.

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

• حساب Your AI Connector نشط مع مفتاح API الخاص بك (الموجود في الإعدادات ← عمليات التكامل ← مفتاح API). مفتاح API هو رمز فريد يسمح لـ GHL بالتواصل بشكل آمن مع حسابك.
• حساب GoHighLevel مع صلاحية إنشاء سير العمل (workflows) وإدارة خطافات الويب (webhooks) (إشعارات آلية بين الأنظمة).

كيف يعمل #

سير العمل 1: من GHL إلى Your AI Connector #

يقوم سير العمل هذا بتوجيه الرسائل الواردة من GHL إلى Your AI Connector.

الخطوة 1: إنشاء سير العمل #

1. في GHL، انتقل إلى الأتمتة > سير العمل (Automation > Workflows).
2. انقر على إنشاء سير عمل جديد (Create New Workflow).
3. امنحه اسمًا وصفيًا، مثل “إرسال رسالة إلى Your AI Connector”.

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

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

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

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

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

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

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

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

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

الخطوة 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):

قيم القناة لكل فرع:

الخطوة 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 في كل مرة يتم فيها إرسال رسالة إلى جهة اتصال. تبدو البيانات المرسلة كما يلي:

{
  "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، انتقل إلى الأتمتة > سير العمل.
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}}:

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

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

{{inboundWebhookRequest.body}}

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

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

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

اختبار من GHL إلى Your AI Connector (سير العمل 1) #

1. أرسل رسالة إلى رقم GHL الخاص بك أو القناة المتصلة (على سبيل المثال، أرسل رسالة نصية قصيرة لنفسك).
2. افتح Your AI Connector وتحقق من ظهور الرسالة في الدردشات (Chats).
3. تأكد من أن تسمية القناة صحيحة (SMS، بريد إلكتروني، إلخ).
4. كرر العملية لكل قناة قمت بتهيئتها.

اختبار من Your AI Connector إلى GHL (سير العمل 2) #

1. في Your AI Connector، أرسل رداً إلى جهة اتصال (يدوياً أو اترك الذكاء الاصطناعي يستجيب).
2. افتح GHL وتحقق من أن جهة الاتصال قد تلقت الرسالة.
3. تأكد من إرسالها عبر القناة الصحيحة.
4. تحقق من تطابق محتوى الرسالة.

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

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

• Webhooks — إعداد webhooks لأحداث Your AI Connector أخرى.
• الوصول إلى API — استخدم API لعمليات التكامل المخصصة بخلاف GHL.
• القنوات المخصصة — تعرف على المزيد حول مراسلة القنوات المخصصة.