يتيح لك تكامل Notion لـ Botpress Studio القيام بالأمور التالية:

# # # الترحيل من الإصدار '0.x' أو '1.x' إلى '2.x'

يضيف الإصدار "2.0" من تكامل Notion دعم OAuth، وهو الآن خيار التكوين الافتراضي.

إذا كنت قد أنشأت سابقًا تكامل Notion في بوابة مطوري Notion وترغب في الاستمرار في استخدام هذا التكامل، يرجى تحديد خيار التكوين اليدوي واتباع الإرشادات أدناه.

بخلاف ذلك، حدد خيار التكوين التلقائي وانقر فوق زر التفويض، ثم اتبع التعليمات التي تظهر على الشاشة لتوصيلchatbot  Botpress  الخاص بك ب Notion.

## التكوين

### التكوين التلقائي باستخدام OAuth (مستحسن)

هذه هي أبسط طريقة لإعداد التكامل. لإعداد تكامل Notion باستخدام OAuth، انقر فوق زر التفويض واتبع التعليمات التي تظهر على الشاشة لتوصيلchatbot  Botpress  الخاص بك ب Notion. يوصى بهذه الطريقة لأنها تبسط عملية التهيئة وتضمن اتصالاً آمناً بين chatbot لي الخاص بك و Notion.

عند استخدام وضع التهيئة هذا، سيتم استخدام تطبيق Notion  Botpress للاتصال بحسابك في Notion . ستُنسب الإجراءات التي يتخذها الروبوت إلى هذا التطبيق، وليس إلى حسابك الشخصي في Notion .

### التكوين اليدوي مع تكامل Notion المخصص

#### الخطوة 1 - إنشاء التكامل

إنشاء تكامل Notion [إنشاء تكامل - مطورو Notion ]notion

#### الخطوة 2 - منح حق الوصول إلى أصول Notion 

امنح تكاملك حق الوصول إلى جميع الصفحات وقواعد البيانات التي تريد استخدامها مع Botpress

#### الخطوة 3 - تكوين الروبوت الخاص بك

امنح تكاملك حق الوصول إلى جميع الصفحات وقواعد البيانات التي تريد استخدامها مع Botpress. [مشاركة قاعدة بيانات مع التكامل الخاص بك - مطورو Notion ]notion

أنت بحاجة إلى رمز مميز للحصول على تكامل Notion Integration الذي تم إنشاؤه حديثًا _(ليس نفس تكامل Notion Studio الخاص بـ Botpress Studio) _ متصل بـ Botpress Studio:

- 'رمز المصادقة' - ستجد هذا من خلال الانتقال إلى التكامل الخاص بك ضمن notion'. بمجرد النقر على التكامل الخاص بك، انتقل إلى قسم "الأسرار" وابحث عن حقل "سر التكامل الداخلي". انقر على "إظهار" ثم "نسخ". قم بلصق الرمز المميز المنسوخ تحت حقل "رمز المصادقة" لتكامل Notion ضمن علامة التبويب "عمليات التكامل" للبوت الخاص بك.

وبذلك تحتاج فقط إلى تمكين التكامل الخاص بك ويمكنك البدء في توسيع قدرات الروبوت الخاص بك مع Notion.

## الاستخدام

تتطلب منك الإجراءات التالية معرفة معرّفات كيانات Notion التي سيعمل الروبوت الخاص بك معها. جميع كيانات notion (الصفحات وقواعد البيانات وما إلى ذلك) لها معرف يمكن العثور عليه في عنوان URL عند زيارة تلك الموجودة في حساب Notion الخاص بك في المتصفح، أو عن طريق الحصول على الرابط بالنقر على عنصر "نسخ الرابط" في قائمة (...). انظر [الحصول على معرف قاعدة بيانات - مطورو Notion ]notion لمزيد من المعلومات

### إضافة تعليق إلى مناقشة

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

### إضافة تعليق إلى صفحة

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

### الحصول على قاعدة بيانات

يتيح لك هذا الإجراء الحصول على تفاصيل قاعدة بيانات. يُستخدم هذا بشكل مثالي مع إجراء 'إضافة صفحة إلى قاعدة بيانات'. وبالإضافة إلى الاستجابة من واجهة برمجة تطبيقات Notion API ([استرجاع قاعدة بيانات - مطورو Notion ]notion، يُرجع هذا الإجراء أيضًا خاصية 'بنية' مُحسَّنة (من الناحية الفنية فك النوع) يمكن استخدامها كمدخل لمهمة الذكاء الاصطناعي لتوجيهها لإنشاء حمولة لإضافة أو تحديث صفحة في قاعدة بيانات Notion بناءً على إدخال المستخدم.

### إضافة صفحة إلى قاعدة بيانات

يجب استخدام هذا الإجراء بشكل مثالي جنبًا إلى جنب مع "الحصول على قاعدة بيانات" الذي يُرجع بنية قاعدة البيانات التي يمكنك استخدامها لتوجيه [مهمة الذكاء الاصطناعي]botpress) لإنشاء حمولة. راجع [العمل مع قواعد البيانات - مطورو Notion ]notion لمزيد من المعلومات.

### حذف كتلة

يمكنك حذف الكيانات التالية:

- صفحة في قاعدة البيانات
- صفحة
- كتلة