> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> دمج Ayrshare API في تطبيق Notion الخاص بك لإدارة حسابات وسائل التواصل الاجتماعي لمستخدميك

## نظرة عامة

[Notion](https://notion.so) هو تطبيق مساحة عمل يجمع بين تدوين الملاحظات وإدارة المشاريع وويكيات وقاعدة بيانات قابلة للتخصيص في واجهة GUI.

من Notion، يمكنك بناء واجهة لإدارة حسابات وسائل التواصل الاجتماعي لمستخدميك باستخدام Ayrshare's social media API، مما يسمح لك بالنشر والحصول على التحليلات وإدارة التعليقات.

## الدرس التعليمي

درس مرئي حول كيفية النشر إلى شبكات وسائل التواصل الاجتماعي الخاصة بك مباشرةً من Notion.
راجع أيضًا [دليل شرح Notion API](https://www.ayrshare.com/blog/schedule-social-media-posts-from-notion/) الخاص بنا.

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/OeGGiG7SmVY" title="Notion Social Posting Integration" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</div>

شيفرة Github لتكامل النشر الاجتماعي في Notion:

<Card title="GitHub: تكامل Ayrshare Notion" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  النشر إلى شبكات وسائل التواصل الاجتماعي الخاصة بك مباشرةً من Notion
</Card>

### إنشاء قاعدة بيانات Notion

في Notion، أنشئ قاعدة بيانات في عرض جدول بأسماء الأعمدة وأنواعها التالية:

<ul class="custom-bullets">
  <li>`Post` كنوع *Title column* (ليس لديك خيار هنا في نوع العمود)</li>

  <li>
    `Platforms` كنوع *Multi Select column* بالقيم: `facebook` و`instagram` و`twitter`
    و`linkedin` و`tiktok` و/أو `telegram`.
  </li>

  <li>`Images` كنوع *Files & Media column*.</li>
  <li>`Profile Keys` كنوع *Text column*.</li>
  <li>`Status` كنوع *Text column*.</li>

  <li>
    `Schedule Date` كنوع *Date column* بتنسيق التاريخ Month/Day/Year، وتنسيق الوقت 24 ساعة،
    وتضمين الوقت
  </li>
</ul>

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/notion-db.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=b83093c27f4fae7e7d3d406eed353f63" alt="Notion Database Examples" width="1536" height="277" data-path="images/packages-guides/notion-db.webp" />

ستُستخدم هذه الحقول في السكربت المحدد لاحقًا في هذه الصفحة. يُرجى ملاحظة أن بعض شبكات وسائل التواصل الاجتماعي "platforms" تتطلب صورًا أو فيديوهات. على سبيل المثال، يتطلب Instagram صورة أو فيديو، وTikTok يتطلب فيديو. يُرجى الاطلاع على [نقاط النهاية](/apis/post/social-networks/facebook) للشبكات المختلفة.

[شاهد مثال Notion مباشر](https://ayrshare-example.notion.site/607c15ce7872456a879adbb0a5f17fdf?v=ee9f65a4afb24033813f245a45bc9e83)

### أدخل بيانات منشور اختباري

نحتاج بعض البيانات العينة لاختبار المنشور. إليك اقتراح:

<ul class="custom-bullets">
  <li>`Post`: أدخل "Happy New Year!"</li>

  <li>
    `Platforms`: اختر شبكة واحدة أو أكثر ربطتها. يُرجى التأكد من أن الاسم بأحرف صغيرة.
  </li>

  <li>`Images`: أرفق [صورة](https://img.ayrshare.com/012/gb.jpg) أو فيديو.</li>
</ul>

<Info>**يجب عليك تحميل صورة إلى Notion.** لا يمكنك استخدام URL صورة.</Info>

<ul class="custom-bullets">
  <li>
    `Profile Keys`: إذا كنت على Business Plan أو Launch Plan وتريد النشر إلى ملف عميل، أدخل
    Profile Key الخاص به. وإلا، اتركه فارغًا.
  </li>

  <li>
    `Status`: أدخل "pending". يلتقط السكربت فقط السجلات المضبوطة على "pending". يُرجى
    التأكد من أن "pending" بأحرف صغيرة.
  </li>

  <li>
    `Schedule Date`: اترك فارغًا حيث سنختبر النشر الفوري الآن فقط. لاحقًا يمكنك
    اختيار تاريخ مستقبلي لجدولة المنشور.
  </li>
</ul>

### إنشاء تكامل داخلي في Notion

اذهب إلى [صفحة My Integrations](https://www.notion.so/my-integrations) في Notion وانقر على New Integration.

[تعرّف على المزيد حول Notion Integrations](https://developers.notion.com/docs/getting-started#utilizing-notions-public-api-for-integrations).

يمكنك تسمية التكامل "Ayrshare" لتحديده بسهولة واختيار مساحة العمل المناسبة التي ستحتوي على بيانات المنشور.

أخيرًا، ستكون القدرات الافتراضية التي حُدّدت لك كافية. أرسل لإنشاء التكامل.

في حال النجاح، سيكون رمز تكامل داخلي متاحًا لك. لاحظ هذا للخطوات المستقبلية في هذه الصفحة.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/create%20notion.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=48dce27786caad8a12c99f04f31a10d4" alt="Create a Notion Integration" width="1536" height="966" data-path="images/packages-guides/create notion.webp" />

واجمع رمز تكامل Notion الخاص بك.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/notion%20token.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=32b0f4d69eeabdc55409e801c6dbf9a7" alt="Get a Notion Secret" width="512" height="253" data-path="images/packages-guides/notion token.webp" />

### ربط قاعدة بيانات Notion بالتكامل الداخلي

افتح قاعدة بيانات Notion التي أنشأتها سابقًا. انقر على النقاط الثلاث في الزاوية اليمنى العليا من الصفحة واذهب إلى **Add Connection**.

هنا يمكنك البحث عن التكامل الداخلي الذي أنشأته في الخطوة السابقة بالاسم الذي اخترته له.

بمجرد النقر على التكامل الداخلي، فقد ربطت الآن قاعدة بيانات Notion هذه بالتكامل.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/connect%20to%20ayrshare.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=318c31733bb8920c5d5765648f6cca80" alt="Connect the Notion Database" width="1536" height="966" data-path="images/packages-guides/connect to ayrshare.webp" />

### تشغيل السكربت لإرسال منشورات من Notion

يمكنك الآن تشغيل سكربت في بيئتك المحلية الذي سيقرأ البيانات من قاعدة بيانات Notion ويُجري منشورًا عبر Ayrshare API لكل صف فيها بحالة "pending".

تأكد من تعيين متغيرات البيئة التالية المستخدمة في السكربت:

<ul class="custom-bullets">
  <li>
    `API_KEY`: هذا هو `API Key` الذي تحصل عليه من Ayrshare. هذا هو مفتاح API الأساسي للملف
    الأساسي في Ayrshare.
  </li>

  <li>
    `NOTION_DATABASE_ID`: افتح قاعدة البيانات التي أنشأتها سابقًا في هذه الصفحة واحصل على معرّف قاعدة البيانات
    من URL.
  </li>
</ul>

<Info>سيكون معرّف قاعدة البيانات هو القيمة قبل ?v= في URL صفحة قاعدة البيانات.</Info>

```html theme={"system"}
https://www.notion.so/company/<NOTION_DATABASE_ID>?v=aaee9f</NOTION_DATABASE_ID>
```

<ul class="custom-bullets">
  <li>`NOTION_KEY`: رمز التكامل الداخلي من قبل.</li>
</ul>

شغّل JavaScript التالي في بيئة Node.js:

<ul class="custom-bullets">
  <li>استنسخ المستودع:</li>
</ul>

```bash theme={"system"}
git clone https://github.com/ayrshare/notion
```

<ul class="custom-bullets">
  <li>cd إلى دليل **notion** وشغّل `npm install`.</li>

  <li>
    حدّث ملف `.env` بـ Ayrshare `API_KEY` وNotion `NOTION_KEY` و
    `NOTION_DATABASE_ID`.
  </li>

  <li>شغّل `node index.js`</li>
</ul>

يمكنك تشغيله على [Heroku](https://www.heroku.com/) أو [Digital Ocean](https://www.digitalocean.com/) أو [Vercel](https://vercel.com/) في الإنتاج.

في حال النجاح، ستُغيَّر جميع أعمدة الحالة `pending` إلى `success` وسيتم إجراء المنشورات على الشبكات الاجتماعية المناسبة.

<Card title="Github: تكامل Ayrshare Notion" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  النشر إلى شبكات وسائل التواصل الاجتماعي الخاصة بك مباشرةً من Notion
</Card>