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

> Tích hợp API Ayrshare vào ứng dụng Notion của bạn để quản lý các tài khoản mạng xã hội của người dùng

## Tổng quan

[Notion](https://notion.so) là một ứng dụng không gian làm việc kết hợp ghi chú, quản lý dự án, wiki và cơ sở dữ liệu có thể tùy chỉnh vào một giao diện GUI.

Từ Notion, bạn có thể xây dựng một giao diện để quản lý các tài khoản mạng xã hội của người dùng với API mạng xã hội của Ayrshare, cho phép bạn đăng bài, lấy phân tích và quản lý bình luận.

## Hướng dẫn

Một hướng dẫn video về cách bạn có thể đăng lên các mạng xã hội trực tiếp từ Notion.
Cũng xem [hướng dẫn API Notion](https://www.ayrshare.com/blog/schedule-social-media-posts-from-notion/) của chúng tôi.

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

Mã Github của tích hợp đăng bài mạng xã hội Notion:

<Card title="GitHub: Tích hợp Notion Ayrshare" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  Đăng lên các mạng xã hội trực tiếp từ Notion
</Card>

### Tạo Cơ sở dữ liệu Notion

Trong Notion, tạo cơ sở dữ liệu ở chế độ xem bảng với các tên cột và loại cột sau:

<ul class="custom-bullets">
  <li>`Post` dưới dạng loại cột *Title* (bạn không có lựa chọn nào khác về loại cột)</li>

  <li>
    `Platforms` dưới dạng loại cột *Multi Select* với các giá trị: `facebook`, `instagram`, `twitter`,
    `linkedin`, `tiktok`, và/hoặc `telegram`.
  </li>

  <li>`Images` dưới dạng loại cột *Files & Media*.</li>
  <li>`Profile Keys` dưới dạng loại cột *Text*.</li>
  <li>`Status` dưới dạng loại cột *Text*.</li>

  <li>
    `Schedule Date` dưới dạng loại cột *Date* với Định dạng Ngày Tháng/Ngày/Năm, Định dạng Giờ 24 Giờ và
    bao gồm giờ
  </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="Ví dụ Cơ sở dữ liệu Notion" width="1536" height="277" data-path="images/packages-guides/notion-db.webp" />

Các trường này sẽ được sử dụng trong script được chỉ định sau trong trang này. Xin lưu ý, một số "platform" mạng xã hội yêu cầu hình ảnh hoặc video. Ví dụ, Instagram yêu cầu hình ảnh hoặc video và TikTok yêu cầu video. Vui lòng xem [các điểm cuối](/apis/post/social-networks/facebook) cho các mạng khác nhau.

[Xem ví dụ Notion trực tiếp](https://ayrshare-example.notion.site/607c15ce7872456a879adbb0a5f17fdf?v=ee9f65a4afb24033813f245a45bc9e83)

### Nhập Dữ liệu Bài đăng Thử

Chúng ta cần một số dữ liệu mẫu để kiểm thử bài đăng. Đây là một đề xuất:

<ul class="custom-bullets">
  <li>`Post`: Nhập "Happy New Year!"</li>

  <li>
    `Platforms`: chọn một hoặc nhiều mạng bạn đã liên kết. Hãy đảm bảo tên viết thường.
  </li>

  <li>`Images`: Đính kèm một [hình ảnh](https://img.ayrshare.com/012/gb.jpg) hoặc một video.</li>
</ul>

<Info>**Bạn phải tải hình ảnh lên Notion.** Bạn không thể sử dụng URL hình ảnh.</Info>

<ul class="custom-bullets">
  <li>
    `Profile Keys`: Nếu bạn đang sử dụng Gói Business hoặc Gói Launch và muốn đăng lên hồ sơ của khách hàng, hãy nhập
    Profile Key của họ. Nếu không, để trống.
  </li>

  <li>
    `Status`: Nhập "pending". Script chỉ lấy các bản ghi được đặt thành "pending". Hãy đảm bảo
    "pending" được viết thường.
  </li>

  <li>
    `Schedule Date`: Để trống vì chúng ta sẽ chỉ kiểm thử đăng bài ngay lập tức. Sau này bạn có thể
    chọn một ngày trong tương lai để lên lịch bài đăng.
  </li>
</ul>

### Tạo Tích hợp Nội bộ trong Notion

Đi đến [trang My Integrations](https://www.notion.so/my-integrations) trong Notion và nhấp vào New Integration.

[Tìm hiểu thêm về Tích hợp Notion](https://developers.notion.com/docs/getting-started#utilizing-notions-public-api-for-integrations).

Bạn có thể đặt tên tích hợp là "Ayrshare" để dễ nhận dạng và chọn không gian làm việc phù hợp sẽ chứa dữ liệu bài đăng.

Cuối cùng, các khả năng mặc định đã được chọn cho bạn sẽ đủ. Gửi để tạo tích hợp.

Nếu thành công, một token tích hợp nội bộ sẽ có sẵn cho bạn. Ghi chú lại điều này cho các bước sau trong trang này.

<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="Tạo một Tích hợp Notion" width="1536" height="966" data-path="images/packages-guides/create notion.webp" />

Và thu thập token tích hợp Notion của bạn.

<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="Lấy Notion Secret" width="512" height="253" data-path="images/packages-guides/notion token.webp" />

### Kết nối Cơ sở dữ liệu Notion với Tích hợp Nội bộ

Mở cơ sở dữ liệu Notion mà bạn đã tạo trước đó. Nhấp vào dấu ba chấm ở góc trên bên phải của trang và đi đến **Add Connection**.

Tại đây, bạn có thể tìm kiếm tích hợp nội bộ bạn đã tạo trong bước trước bằng cách nhập tên bạn đã chọn cho nó.

Khi bạn nhấp vào tích hợp nội bộ, bạn đã kết nối cơ sở dữ liệu Notion này với tích hợp.

<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="Kết nối Cơ sở dữ liệu Notion" width="1536" height="966" data-path="images/packages-guides/connect to ayrshare.webp" />

### Chạy script để Gửi Bài đăng từ Notion

Bây giờ bạn có thể chạy một script trong môi trường cục bộ của mình sẽ đọc dữ liệu từ cơ sở dữ liệu Notion và thực hiện đăng bài thông qua API Ayrshare cho mỗi hàng trong đó với trạng thái "pending".

Hãy đảm bảo đặt các biến môi trường sau được sử dụng trong script:

<ul class="custom-bullets">
  <li>
    `API_KEY`: đây là `API Key` bạn nhận được từ Ayrshare. Đây là API Key chính cho
    profile chính Ayrshare của bạn.
  </li>

  <li>
    `NOTION_DATABASE_ID`: Mở cơ sở dữ liệu bạn đã tạo trước đó trong trang này và lấy database ID
    từ URL.
  </li>
</ul>

<Info>Database ID sẽ là giá trị trước ?v= trong URL trang cơ sở dữ liệu.</Info>

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

<ul class="custom-bullets">
  <li>`NOTION_KEY`: token tích hợp nội bộ từ trước đó.</li>
</ul>

Chạy JavaScript sau trong môi trường Node.js:

<ul class="custom-bullets">
  <li>Sao chép kho lưu trữ:</li>
</ul>

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

<ul class="custom-bullets">
  <li>cd vào thư mục **notion** và chạy `npm install`.</li>

  <li>
    Cập nhật tệp `.env` với `API_KEY` Ayrshare, `NOTION_KEY` và
    `NOTION_DATABASE_ID` Notion.
  </li>

  <li>Chạy `node index.js`</li>
</ul>

Bạn có thể chạy nó tại [Heroku](https://www.heroku.com/), [Digital Ocean](https://www.digitalocean.com/) hoặc [Vercel](https://vercel.com/) trong sản xuất.

Nếu thành công, tất cả các cột trạng thái `pending` sẽ được thay đổi thành `success` và các bài đăng sẽ được thực hiện đến các mạng xã hội phù hợp.

<Card title="Github: Tích hợp Notion Ayrshare" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  Đăng lên các mạng xã hội trực tiếp từ Notion
</Card>