الصفحات وقواعد البيانات

يربط تكامل Notion تطبيق وولفيش بمساحة عمل Notion للبحث والقراءة والإنشاء والاستعلام في الصفحات وقواعد البيانات. يستخدم رمز تكامل Notion الداخلي للمصادقة.

الإعداد

إنشاء تكامل

انتقل إلى notion.so/my-integrations واضغط “تكامل جديد”. أعطه اسمًا (مثل “وولفيش”) واختر مساحة العمل.

نسخ الرمز

بعد الإنشاء، انسخ رمز التكامل الداخلي (يبدأ بـ ntn_ أو secret_).

التهيئة في وولفيش

افتح الإعدادات > التكاملات > Notion، واضغط إضافة، وأعطِ الاتصال تسمية (مثل «شخصي»)، والصق الرمز. زرّ اختبار يتحقق منه ويعرض مساحة العمل التي يقود إليها.

مشاركة الصفحات مع التكامل

في Notion، افتح كل صفحة أو قاعدة بيانات تريد أن يصل إليها وولفيش. اضغط قائمة ”…” > “الاتصالات” > ابحث عن تكاملك واربطه.

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

عدّة مساحات عمل

يمكنك ربط أي عدد من مساحات عمل Notion، كلٌّ منها اتصالٌ بتسميته الخاصة («شخصي»، «عمل»). وكلّ أدوات notion_* تقبل معامل connection اختيارياً يسمّي التسمية:

اتصال واحد مُهيّأ — يُستخدم تلقائياً؛ لا تحتاج لتمرير شيء.
عدّة اتصالات — تطلب الأدوات التسمية عند الالتباس، وأداة notion_connections الجديدة تسرد المتاح. في المحادثة يكفي أن تقول أيّ مساحةٍ تقصد: «أضفه إلى Notion العمل».

الإعدادات القديمة برمزٍ واحد تنتقل تلقائياً إلى اتصالٍ بتسمية.

الأدوات المتاحة

البحث والقراءة

الأداة	الوصف
`notion_search`	البحث في الصفحات وقواعد البيانات بالعنوان أو المحتوى
`notion_read_page`	قراءة خصائص الصفحة (العنوان، التواريخ، الوسوم، إلخ)
`notion_read_blocks`	قراءة محتوى كتل الصفحة (فقرات، قوائم، شفرة برمجية، إلخ)

الإنشاء والتحديث

الأداة	الوصف
`notion_create_page`	إنشاء صفحة جديدة في صفحة أب أو قاعدة بيانات
`notion_update_page`	تحديث خصائص الصفحة
`notion_append_blocks`	إلحاق كتل جديدة بنهاية الصفحة

قواعد البيانات

الأداة	الوصف
`notion_create_database`	إنشاء قاعدة بيانات جديدة بخصائص محددة
`notion_query_database`	استعلام قاعدة بيانات بفلاتر وترتيب
`notion_add_comment`	إضافة تعليق على صفحة أو نقاش

الاستعلام في قواعد البيانات

تدعم أداة notion_query_database صيغة الفلترة والترتيب في Notion:

{
  "database_id": "abc123...",
  "filter": {
    "property": "Status",
    "status": {
      "equals": "In Progress"
    }
  },
  "sorts": [
    {
      "property": "Priority",
      "direction": "descending"
    }
  ]
}

الفلاتر المركّبة مدعومة:

{
  "filter": {
    "and": [
      {
        "property": "Status",
        "status": { "equals": "In Progress" }
      },
      {
        "property": "Assignee",
        "people": { "contains": "user-id-here" }
      }
    ]
  }
}

لا تحتاج لكتابة JSON الفلترة الخام بنفسك. فقط صِف ما تريده — “أرني المهام المسندة إليّ التي قيد التنفيذ” — وسيبني النموذج اللغوي الفلتر المناسب.

أنواع الكتل المدعومة

عند إنشاء أو إلحاق محتوى، يدعم وولفيش أنواع كتل Notion التالية:

نوع الكتلة	الوصف
`paragraph`	فقرة نصية عادية
`heading_1`	عنوان كبير
`heading_2`	عنوان متوسط
`heading_3`	عنوان صغير
`bulleted_list_item`	عنصر قائمة نقطية
`numbered_list_item`	عنصر قائمة مرقّمة
`toggle`	كتلة قابلة للطي
`code`	كتلة شفرة برمجية مع تلوين بناء الجملة
`quote`	اقتباس
`callout`	تنبيه مع أيقونة
`divider`	فاصل أفقي
`table`	كتلة جدول
`bookmark`	رابط محفوظ

المحفّزات

تُفعّل قدرة Notion عندما تتطابق رسالتك مع أي من هذه الأنماط:

notion, workspace, wiki, knowledge base,
database, page, kanban, board, backlog,
sprint, project tracker, notes

أمثلة على سير العمل

البحث في مساحة العمل

You: "Search my Notion for the API spec"
Wolffish: Calls notion_search with "API spec" and returns matching pages
with titles and parent locations.

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

You: "Add a new task to my project database: implement login flow, priority high"
Wolffish: Calls notion_create_page with the database as parent and sets
the Title, Status, and Priority properties.

استعلام المهام قيد التنفيذ

You: "What tasks are in progress?"
Wolffish: Calls notion_query_database with a Status = "In Progress" filter
and returns matching entries with their properties.

إلحاق محتوى بصفحة

You: "Add a section about error handling to my API documentation page"
Wolffish: Searches for the page, then calls notion_append_blocks with
heading and paragraph blocks containing the new content.

مرجع التهيئة

تُخزَّن الاتصالات في config.json كمصفوفةٍ بتسميات:

{
  "notion": {
    "connections": [
      {
        "id": "nt-a1b2c3",
        "label": "شخصي",
        "token": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "name": "Wolffish",
        "email": "you@example.com"
      }
    ]
  }
}

حقلا name وemail يُستنتَجان تلقائياً عند اختبار الرمز. والشكل القديم برمزٍ واحد ({ "token": "…" }) ينتقل تلقائياً إلى اتصالٍ بتسمية “Default” عند أول حفظ.

واجهة Notion API لديها حدود استخدام (3 طلبات في الثانية للتكاملات). يتعامل وولفيش مع إعادة المحاولات بتأخير تصاعدي تلقائيًا عبر وحدة motor. إذا كنت تجري عمليات جماعية، قد تكون الاستجابات أبطأ قليلًا من المعتاد.

لا تشارك أبدًا رمز تكامل Notion. أي شخص يملك الرمز يمكنه قراءة وتعديل جميع الصفحات التي يملك التكامل صلاحية الوصول إليها. إذا اشتبهت بتسرّب الرمز، قم بتدويره فورًا في notion.so/my-integrations.

ابدأ هنا

المفاهيم الأساسية

القدرات

القنوات

النماذج

التكاملات

الذاكرة والتعلم

التكوين

التشخيص

توسيع وولفيش

التطوير

Notion

الصفحات وقواعد البيانات

الإعداد

عدّة مساحات عمل

الأدوات المتاحة

البحث والقراءة

الإنشاء والتحديث

قواعد البيانات

الاستعلام في قواعد البيانات

أنواع الكتل المدعومة

المحفّزات

أمثلة على سير العمل

مرجع التهيئة

​الصفحات وقواعد البيانات

​الإعداد

​عدّة مساحات عمل

​الأدوات المتاحة

​البحث والقراءة

​الإنشاء والتحديث

​قواعد البيانات

​الاستعلام في قواعد البيانات

​أنواع الكتل المدعومة

​المحفّزات

​أمثلة على سير العمل

​مرجع التهيئة

الصفحات وقواعد البيانات

الإعداد

عدّة مساحات عمل

الأدوات المتاحة

البحث والقراءة

الإنشاء والتحديث

قواعد البيانات

الاستعلام في قواعد البيانات

أنواع الكتل المدعومة

المحفّزات

أمثلة على سير العمل

مرجع التهيئة