الانتقال إلى المحتوى الرئيسي

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

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

​
الإعداد

1

إنشاء تكامل

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

نسخ الرمز

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

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

افتح الإعدادات > التكاملات > Notion والصق الرمز.
4

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

في 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.

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

يُخزّن رمز Notion كمتغير في الإعدادات: 
{
  "variables": {
    "NOTION_TOKEN": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
بدلًا من ذلك، في config.json: 
{
  "integrations": {
    "notion": {
      "token": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}
واجهة Notion API لديها حدود استخدام (3 طلبات في الثانية للتكاملات). يتعامل وولف فيش مع إعادة المحاولات بتأخير تصاعدي تلقائيًا عبر وحدة motor. إذا كنت تجري عمليات جماعية، قد تكون الاستجابات أبطأ قليلًا من المعتاد.
لا تشارك أبدًا رمز تكامل Notion. أي شخص يملك الرمز يمكنه قراءة وتعديل جميع الصفحات التي يملك التكامل صلاحية الوصول إليها. إذا اشتبهت بتسرّب الرمز، قم بتدويره فورًا في notion.so/my-integrations.