Các kết nối API Notion

Truy cập trung tâm nhà phát triển của chúng tôi để xem tài liệu, tài nguyên và các công cụ quản lý kết nối.

1. Trong thanh bên trái của bạn, hãy điều hướng đến Cài đặt và sau đó là tab Kết nối.

2. Chỉ chủ sở hữu Không gian làm việc mới có thể truy cập tab Kết nối và tạo các tích hợp. Nếu bạn không phải là quản trị viên, vui lòng liên hệ với quản trị viên Không gian làm việc của bạn hoặc sử dụng một không gian làm việc khác.

3. Nhấp vào liên kết Phát triển các kết nối của riêng bạn ở dưới cùng.

4. Các kết nối của tôi sẽ mở trong trình duyệt mặc định của bạn. Nhấp vào /nút + Mới.

5. Cung cấp Tên cho kết nối của bạn. Tùy chọn, bạn cũng có thể tải lên một hình ảnh để sử dụng làm Logo.

6. Sử dụng menu thả xuống để chỉ định Không gian làm việc được liên kết mà bạn muốn sử dụng kết nối này.

   

   Ghi chú: Hãy đảm bảo bạn đã đăng nhập vào Notion trên phiên web của mình bằng cùng tài khoản mà bạn đã sử dụng trên máy tính để bàn. Nếu không, bạn sẽ không thấy đúng tài khoản và không gian làm việc!

   

7. Kết nối nội bộ của bạn đã được thêm thành công! Giờ đây, bạn sẽ có thể thấy nó trong không gian làm việc của mình, trong menu Cài đặt → Kết nối.

8. Nhấp vào ••• bên cạnh kết nối nội bộ để truy xuất mã thông báo kết nối nội bộ. Bạn sẽ cần mã thông báo này cho bất kỳ quy trình làm việc hoặc tự động hóa dựa trên API nào mà nhóm của bạn tạo, hoặc để liên kết không gian làm việc của bạn với một số nền tảng đối tác.

Tất cả các kết nối mới được thêm ban đầu đều là kết nối nội bộ. Nếu bạn là nhà phát triển đang làm việc trên một kết nối công khai, trước tiên hãy sử dụng các hướng dẫn ở trên để tạo một kết nối nội bộ.

Sau đó, hãy làm theo các hướng dẫn trong hướng dẫn dành cho nhà phát triển của chúng tôi để chuyển đổi nó thành kết nối công khai.

Trong quá trình thiết lập ứng dụng, các nhà phát triển sẽ có thể chọn cấp độ truy cập cần thiết từ người dùng.

• Khả năng về nội dung:

  • Chỉ đọc nội dung

  • Chỉ ghi nội dung

  • Chèn nội dung

• Khả năng của người dùng

  • Không có thông tin người dùng

  • Đọc thông tin người dùng (không bao gồm địa chỉ email của người dùng)

  • Đọc thông tin người dùng (bao gồm email)

Khi người dùng cài đặt kết nối, cấp độ truy cập này sẽ được hiển thị. Nó cũng sẽ hiển thị trong menu chia sẻ của bất kỳ trang nào mà kết nối đã được thêm vào. Tìm hiểu thêm về việc cài đặt kết nối trong không gian làm việc →

Webhook kết nối cho phép các kết nối giám sát và phản hồi các thay đổi trong không gian làm việc Notion theo thời gian thực.

Khi các thay đổi xảy ra trong các trang hoặc cơ sở dữ liệu được chia sẻ với kết nối của bạn, Notion sẽ tự động gửi thông báo đến điểm cuối webhook của bạn, cho phép kết nối của bạn cập nhật ngay lập tức các công cụ khác, chạy các tác vụ tự động hoặc hiển thị các thay đổi mới nhất.

Để biết hướng dẫn, vui lòng truy cập tài liệu dành cho nhà phát triển của chúng tôi.

Webhook hành động và webhook kết nối có một số điểm tương đồng—cả hai đều có trình kích hoạt và có thể gửi sự kiện đến các dịch vụ của bên thứ ba. Tuy nhiên, webhook kết nối cung cấp các khả năng rộng hơn:

• Chúng có thể giám sát hoạt động trên nhiều không gian làm việc.

• Chúng có thể xử lý số lượng hành động không giới hạn.

Ngược lại, webhook hành động được thiết kế cho các trường hợp sử dụng đơn giản hơn và được định cấu hình thông qua tự động hóa cơ sở dữ liệu với một tập hợp trình kích hoạt hạn chế.