> ## 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

> Інтегруйте API Ayrshare у ваш додаток Notion для керування акаунтами соціальних мереж ваших користувачів

## Огляд

[Notion](https://notion.so) — це додаток для робочого простору, який поєднує ведення нотаток, керування проєктами, вікі та настроювану базу даних у графічному інтерфейсі.

З Notion ви можете створити інтерфейс для керування акаунтами соціальних мереж ваших користувачів за допомогою API соціальних мереж Ayrshare, що дозволяє публікувати дописи, отримувати аналітику та керувати коментарями.

## Навчальний посібник

Відеопосібник про те, як публікувати дописи у ваших соціальних мережах безпосередньо з Notion.
Також перегляньте наш [покроковий посібник з API Notion](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>

Код інтеграції Notion для публікацій у соціальних мережах на GitHub:

<Card title="GitHub: Ayrshare Notion Integration" 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](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 і виконуватиме публікацію через API Ayrshare для кожного рядка зі статусом «pending».

Обов’язково встановіть такі змінні середовища, які використовуються у скрипті:

<ul class="custom-bullets">
  <li>
    `API_KEY`: це `API Key`, який ви отримуєте від Ayrshare. Це основний API Key для вашого
    Primary Profile Ayrshare.
  </li>

  <li>
    `NOTION_DATABASE_ID`: відкрийте базу даних, створену раніше на цій сторінці, та отримайте ID бази даних
    з URL-адреси.
  </li>
</ul>

<Info>ID бази даних — це значення перед ?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>Перейдіть у каталог **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 Integration" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  Публікуйте у своїх соціальних мережах безпосередньо з Notion
</Card>