تعد روبوتات الدردشة ذات قيمة للعديد من فرق تفاعل العملاء. فهي تتعامل بكفاءة مع الأسئلة البسيطة وتتيح للوكلاء البشريين التركيز على قضايا أكثر إلحاحًا.

تُعتبر Dialogflow و[Rasa.ai](http://Rasa.ai) من أبرز منصات معالجة اللغة الطبيعية (NLP) لبناء روبوتات دردشة مخصصة. في هذا الدليل، نشرح كيفية إنشاء روبوت في Dialogflow ودمجه بسهولة مع Chatwoot خلال ثوانٍ قليلة.

## كيف تنشئ روبوت Dialogflow؟

**الخطوة 1.** انتقل إلى [وحدة تحكم Dialogflow](https://dialogflow.cloud.google.com/). سنستخدم Dialogflow Essentials في هذا المقال. انقر على "Create Agent". ستظهر لك خيارات مثل هذه:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeENJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6d9926ae1dc31a8250ec6fc01dcff523501c80c6/create%20agent%20in%20dialogflow%20console.png)

\
**الخطوة 2.** ستحتاج إلى إنشاء "نوايا" (intents) حسب كيفية استجابة روبوتك. سيكون هناك نيتان افتراضيتان في المشروع باسم "Default Fallback Intent" و"Default Welcome Intent" كما هو موضح أدناه.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeEdJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--84b949a70c890b4d912e7e0675f35c974a40bd12/creating%20intents%20in%20dialogflow.png)

هذا يُكمل إعداد الروبوت الأساسي. لنقم بإنشاء حساب خدمة وربطه مع Chatwoot.

> يمكنك أيضًا إنشاء نوايا إضافية لحالات الاستخدام الخاصة بك.\
> يدعم Chatwoot أيضًا نوايا متقدمة تتيح [تحويل المحادثة إلى وكيل](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#creating-a-handoff-intent) و[الرسائل التفاعلية](https://www.chatwoot.com/hc/user-guide/articles/1788726344-) وما إلى ذلك.\
> المرجع: مرر إلى أسفل إلى "النوايا المتقدمة".

**الخطوة 3.** إنشاء حساب خدمة[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#create-a-service-account "Direct link to heading"). لربط هذا الروبوت مع Chatwoot يجب إنشاء حساب خدمة في وحدة تحكم Google Cloud. انتقل إلى وحدة تحكم المشروع في Google Cloud بالنقر على **Project ID** في إعدادات المشروع.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMUtJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0609885eaed20b42c79ac5b88d09602449d97a2f/project%20ID.png)

انتقل إلى **IAM & Admin -> Service Accounts**. سترى عرضاً مماثلاً للذي في الأسفل. انقر على "Create Service Account".

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMU9JVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6678ad3e6c5c9536cfd2dd5d1b83766b459486d6/service%20accounts.png)

أدخل اسم حساب الخدمة والوصف كما هو موضح أدناه.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMVdJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--444a6e86cf22a04c36bc4a0de153cf836fe17600/setting%20service%20account%20up.png)

لتوفير الوصول، اختر Dialogflow API Client من القائمة المنسدلة.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMWFJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f0814a4a0a8f6d84a0aa3dfd96c566cd46c18014/dialogflow%20api%20client.png)

تابع وانقر على "Done". الآن، سيكون بإمكانك رؤية الخدمة مدرجة في لوحة المعلومات. الخطوة التالية هي إنشاء مفتاح ليتم مشاركته مع Chatwoot. انقر على حساب الخدمة ثم على تبويب "Keys". بعد ذلك، انقر على "Add Key". ستظهر لك شاشة مماثلة لما يلي.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMktJVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b67cdd18d8a10c64e3ba983808fb15f65543644e/api%20key.png)

\
انقر على "JSON" ثم على "Create". سيقوم بإنشاء مفتاح لحساب الخدمة الخاص بك. قم بتنزيل المفتاح واحتفظ به للاستخدام لاحقًا.

## إعداد تكامل Dialogflow في Chatwoot[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#configuring-dialogflow-integration-in-chatwoot "Direct link to heading")

يحتوي Chatwoot على تكامل تلقائي مع Dialogflow. يمكنك ربط روبوتك مع Chatwoot في خطوتين سريعتين.

**الخطوة 1.** اذهب إلى "Settings -> Applications -> Dialogflow". انقر على "Configure".

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeDJKVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e3852efe92d0c5e6c0c04751a0942db20dad9608/adding%20dialogflow%20option%20in%20chatwoot.png)

**الخطوة 2.** انقر على زر "Add a new hook". سيظهر لك نموذج إعداد. يلزمك إضافة "Project ID" و"Project Key file" وصندوق بريد لإنشاء hook. انسخ محتويات ملف المفتاح الذي تم تنزيله مسبقاً والصقه في منطقة النص.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeDZKVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5d23fddf59970ebc4573e7bfda3bddac0c8113f4/dialoglow%20settings.png)

هذا كل شيء! تم اكتمال التكامل. اختبر صندوق البريد على موقع الويب لتتحقق من معالجة الروبوت للاستفسار الأولي.

## النوايا المتقدمة[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#advanced-intents "Direct link to heading")

### إنشاء نية تحويل للمحادثة إلى وكيل[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#creating-a-handoff-intent "Direct link to heading")

بمجرد أن يطلب المستخدم التحدث مع وكيل، يجب على Dialogflow إبلاغ Chatwoot أن الوكيل يمكنه تولي المحادثة.

أنشئ نية باسم "Handoff Intent" مع عبارات تدريبية مثل "تحدث مع وكيل" أو "كلمني مع وكيل"، وما إلى ذلك. للتعامل مع نية التحويل سنقوم بإنشاء استجابة "Custom Payload" كما يلي.

```
{
  "action": "handoff"
}
```

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBM2lKVHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--09cb509c898b8226a50c99a3ca288ef24f646438/handoff%20intent.png)

عند تفعيل نية تحوي الحمولة أعلاه، سيبدل Chatwoot حالة المحادثة إلى `open` ويسلمها إلى وكيل.

### الرسائل التفاعلية[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#interactive-messages "Direct link to heading")

**ملاحظة**: الرسائل التفاعلية مدعومة حالياً فقط في صندوق البريد على موقع الويب.

يدعم تكامل Chatwoot-Dialogflow أيضًا [الرسائل التفاعلية](https://www.chatwoot.com/hc/user-guide/articles/1788726344-). الأنواع التالية من الرسائل التفاعلية مدعومة.

1. [خيارات](https://www.chatwoot.com/hc/user-guide/articles/1788726344-) (تدعم المتابعة)

2. [بطاقات](https://www.chatwoot.com/hc/user-guide/articles/1788726344-)

3. [مقالات](https://www.chatwoot.com/hc/user-guide/articles/1788726344-)

#### **إنشاء نية رسالة تفاعلية**[**​**](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#creating-an-interactive-message-intent "Direct link to heading")

يمكنك إنشاء رسائل تفاعلية أخرى بتغيير الحمولة كما هو مذكور في [دليل الرسائل التفاعلية](https://www.chatwoot.com/docs/product/others/interactive-messages).

أنشئ نية بعبارات تدريبية مطلوبة واستجابة "Custom Payload" كما هو موضح أدناه لرسالة خيارات.

```
## مثال لرسالة خيارات تفاعلية
{
  "content_type": "input_select",
  "content": "اختر طعامك المفضل من الأسفل",
  "content_attributes": {
    "items": [
      {
        "value": "I like sushi",
        "title": "Sushi"
      },
      {
        "title": "Biryani",
        "value": "I like biryani"
      },
      {
        "title": "Pizza",
        "value": "I like pizza"
      }
    ]
  },
  "private": false
}
```

عندما يتفاعل المستخدم مع الرسائل المدخلة ويختار قيمة، يتم إرجاعها إلى Dialogflow. يتيح ذلك تكوين نوايا متابعة، مثل إنشاء نية بعبارة تدريبية "I like biryani" للحالات التي يختار فيها المتصل خيار "biryani".

## كيف يمكن للوكيل إعادة المحادثة إلى روبوت Dialogflow؟[​](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#how-can-an-agent-transfer-the-conversation-back-to-dialoflow-bot "Direct link to heading")

عندما يكون روبوت Dialogflow متصلًا بصندوق بريد، يتم إنشاء المحادثات بحالة `pending` بدلاً من `open`. يسمح ذلك بإجراء الفحص الأولي عبر الروبوت قبل نقل المحادثة إلى وكيل. عند حدوث [`handoff`](https://www.chatwoot.com/docs/product/channels/live-chat/integrations/dialogflow/#creating-a-handoff-intent)، تتغير حالة المحادثة إلى `open` ويتوقف الروبوت عن الرد عليها.

في بعض الأحيان قد يرغب الوكلاء في إرجاع المحادثة التي تم تحويلها إلى طابور الروبوت من جديد. يمكنهم ذلك بتغيير حالة المحادثة إلى `pending` مرة أخرى. سيجعل هذا الروبوت يبدأ في الرد على تلك المحادثة مرة أخرى.