تودويست

  ادمج chatbot مع Todoist لإنشاء المهام وتعديلها ونشر التعليقات والمزيد.

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

إذا كنت تقوم بالترحيل من الإصدار '0.x' إلى الإصدار '1.x'، يرجى ملاحظة التغييرات الفاصلة التالية:

> تم استبدال إجراء "إنشاء مهمة" بإجراء "إنشاء مهمة جديدة".

## التكوين

### التكوين التلقائي مع OAuth

لإعداد تكامل Todoist باستخدام OAuth، انقر فوق زر التفويض واتبع التعليمات التي تظهر على الشاشة لتوصيل Botpress chatbot  الخاص بك ب Todoist.

عند تكوين الروبوت الخاص بك باستخدام OAuth، يمكنك إما تسجيل الدخول بحساب المستخدم الخاص بك أو بحساب مستخدم قمت بإنشائه خصيصًا لروبوتك.
يُرجى الأخذ في الاعتبار أنه إذا قمت بتسجيل الدخول بحساب المستخدم الخاص بك، فستظهر إجراءات الروبوت وتعليقاته على أنها لك.
بالنسبة لمعظم حالات الاستخدام، يوصى بإنشاء حساب مستخدم خصيصًا للبوت الخاص بك. سيتعين عليك دعوة مستخدم الروبوت إلى مشروع مشترك حتى يتمكن من نشر التعليقات والقيام بالإجراءات وما إلى ذلك.

### التكوين اليدوي باستخدام رمز واجهة برمجة التطبيقات الشخصية

1. إنشاء تطبيق Todoist
   - أنشئ تطبيقًا في [صفحة إدارة التطبيقات] (https://developer.todoist.com/appconsole.html).
   - انسخ رمز API المميز الشخصي لواجهة برمجة التطبيقات الخاص بالمستخدم أو أنشئ رمزًا مميزًا تجريبيًا في صفحة إدارة التطبيقات.
2. تكوين تكامل Todoist Botpress 
   - قم بتثبيت تكامل Todoist في الروبوت Botpress الخاص بك.
   - الصق رمز واجهة برمجة التطبيقات الذي تم نسخه مسبقًا في حقول التكوين. هذا هو الرمز المميز الذي سيستخدمه الروبوت الخاص بك لنشر التعليقات أو تحديث المهام أو إنشائها وما إلى ذلك.
   - احفظ التكوين.
   - انسخ عنوان URL Webhook الخاص بالبوت الخاص بك.
3. تكوين تطبيق Todoist Webhook 
   - انتقل إلى صفحة إدارة التطبيقات في تطبيقك على Todoist.
   - تأكد من تنشيط أحداث Webhooks. اتبع [هذه التعليمات] (https://developer.todoist.com/sync/v9/#webhooks) التي يوفرها Todoist للقيام بذلك.
   - الصق عنوان URL Webhook الذي تم نسخه مسبقًا في الحقل _عنوان URL الخاص بردود اتصال خطاف الويب_.
   - تحقق من _الأحداث المشاهدة_ التالية:
     - _item:تمت إضافته_;
     - _item:تم تحديثه_;
     - _عنصر:مكتمل_;
     - _ملاحظة:تمت الإضافة_.
   - احفظ التكوين Webhook .

## القيود

تنطبق قيود واجهة برمجة تطبيقات Todoist القياسية على تكامل Todoist في Botpress. تتضمن هذه القيود حدود المعدل وقيود حجم الحمولة والقيود الأخرى التي يفرضها Todoist. تأكد من التزام chatbot الخاص بك بهذه القيود للحفاظ على الأداء والموثوقية المثلى.

يتوفر المزيد من التفاصيل في [Todoist Developer Documenter] (https://developer.todoist.com/rest/v2/#request-limits).