Tích hợp API với N8N: Hướng dẫn từng bước
Hiểu N8N
N8N là một công cụ tự động hóa dòng công việc nguồn mở cho phép người dùng kết nối các ứng dụng khác nhau thông qua API (giao diện lập trình ứng dụng). Bằng cách đơn giản hóa quá trình tích hợp các ứng dụng khác nhau, N8N cho phép bạn tạo các quy trình công việc mạnh mẽ có thể tự động hóa các tác vụ mà không cần viết mã rộng rãi. Nó hỗ trợ một loạt các công cụ, bao gồm các dịch vụ web phổ biến như Google Sheets, Slack và MongoDB, cung cấp sự linh hoạt cho các nhà phát triển, nhà phân tích và nhà tiếp thị.
Điều kiện tiên quyết
Trước khi đi vào quá trình tích hợp, điều quan trọng là phải đảm bảo bạn có:
- Một thể hiện N8N chạy (cục bộ hoặc lưu trữ).
- Kiến thức cơ bản về API và cách chúng hoạt động.
- Các tài khoản được thiết lập cho API bạn muốn tích hợp (ví dụ: Google, Slack).
Thiết lập N8N
-
Cài đặt
- Nếu bạn chưa thiết lập N8N, hãy làm theo các bước sau:
- Cài đặt Docker: Chạy
docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
trong thiết bị đầu cuối của bạn. - Cài đặt cục bộ: Sử dụng Node.js để cài đặt N8N qua NPM với
npm install n8n -g
sau đó chạyn8n
.
- Cài đặt Docker: Chạy
- Nếu bạn chưa thiết lập N8N, hãy làm theo các bước sau:
-
Truy cập Trình chỉnh sửa N8N
- Mở trình duyệt của bạn và điều hướng đến
localhost:5678
. Bạn sẽ thấy giao diện trình soạn thảo N8N nơi bạn có thể tạo và quản lý quy trình công việc của mình.
- Mở trình duyệt của bạn và điều hướng đến
Tạo quy trình làm việc đầu tiên của bạn
-
Tạo một quy trình làm việc mới
- Nhấp vào “quy trình công việc” trong thanh điều hướng hàng đầu, sau đó chọn trên mạng mới để bắt đầu một quy trình công việc trống.
-
Đổi tên quy trình làm việc
- Ở đầu trình soạn thảo, nhấp vào quy trình làm việc trên mạng và đặt cho quy trình làm việc của bạn một tên có liên quan.
Tích hợp API: Ví dụ về Google Sheets
Bước 1: Thêm nút Google Sheets
-
Thêm nút
- Nhấp vào dấu hiệu “+” để thêm một nút mới vào quy trình làm việc của bạn. Tìm kiếm cho Google Google Sheets và chọn nó.
-
Xác thực
- N8N yêu cầu xác thực để tương tác với Google Sheets. Nhấp vào Tạo Tạo mới trong phần Xác thực.
- Bạn sẽ được chuyển hướng đến màn hình xác thực của Google. Thực hiện theo lời nhắc để cho phép N8N truy cập tài khoản Google Sheets của bạn.
- Sau khi kết nối thành công, chọn thông tin đăng nhập thích hợp từ menu thả xuống.
Bước 2: Cấu hình nút Google Sheets
-
Chọn hoạt động
- Trong cài đặt nút Google Sheets, chọn thao tác bạn muốn thực hiện, chẳng hạn như “Tạo”, “Cập nhật” hoặc “Nhận nhiều”. Đối với ví dụ này, hãy chọn cách tạo ra.
-
Chọn trang tính và cột
- Chỉ định bảng tính và trang tính trong Google Sheets bạn dự định làm việc cùng. Chọn cẩn thận hoặc nhập các cột nơi dữ liệu sẽ được chèn.
Bước 3: Ánh xạ dữ liệu
- Giá trị đầu vào
- Trong phần “Giá trị”, bạn có thể chỉ định dữ liệu mà bạn muốn gửi đến nút này. Sử dụng nút Thêm giá trị giá trị để xác định dữ liệu trên mỗi cột bạn đã chọn trước đó.
- Bạn có thể ánh xạ các giá trị tĩnh hoặc truy xuất các giá trị động từ các nút trước đó trong quy trình công việc.
Bước 4: Kiểm tra tích hợp Google Sheets
-
Thực hiện quy trình làm việc
- Nhấp vào nút thực hiện quy trình công việc trên mạng ở trên cùng bên phải. Điều này sẽ chạy quy trình làm việc và tích hợp dữ liệu vào tờ Google được chỉ định.
-
Xem xét đầu ra
- Kiểm tra Google Sheets cho mục mới đã được thêm vào để xác nhận tích hợp đã thành công.
Tích hợp API khác: Ví dụ về Slack
Bước 1: Thêm nút Slack
-
Chèn nút
- Một lần nữa, nhấp vào dấu hiệu ‘+’ để thêm một nút khác và tìm kiếm cho Slack Slack.
-
Xác thực
- Tương tự như Google Sheets, chọn xác thực với Slack. Nếu bạn chưa thêm thông tin xác thực cho Slack, hãy chọn “Tạo mới.”
- Thực hiện theo quy trình ủy quyền của Slack, cấp cho N8N các quyền cần thiết.
Bước 2: Cấu hình nút chùng
-
Chọn hoạt động
- Chọn hành động nào bạn muốn thực hiện trong Slack, chẳng hạn như “Gửi tin nhắn”.
-
Chỉ định kênh và tin nhắn
- Nhập tên của kênh nơi bạn muốn gửi tin nhắn.
- Trong trường “Tin nhắn”, bạn có thể nhập văn bản tĩnh hoặc dữ liệu động được lấy từ các nút trước đó trong quy trình làm việc.
Bước 3: Liên kết các nút Google và nút chùng
- Kết nối các nút
- Kéo một dòng từ nút Google Sheets vào nút Slack để thiết lập mối quan hệ. Chuỗi này cho phép dữ liệu được thu thập từ Google Sheets được gửi trực tiếp đến Slack.
Bước 4: Kiểm tra tích hợp chùng
-
Chạy quy trình làm việc
- Thực hiện lại quy trình công việc. Dữ liệu từ Google Sheets hiện sẽ được gửi đến kênh Slack đã chọn của bạn.
-
Kiểm tra kênh Slack
- Đi đến kênh được chỉ định trong Slack để xem tin nhắn đã được gửi.
Các tính năng nâng cao cho quy trình công việc phức tạp hơn
Logic có điều kiện với các nút
- Đôi khi, bạn có thể chỉ muốn gửi một tin nhắn nếu một điều kiện cụ thể được đáp ứng, chẳng hạn như giá trị từ Google Sheets vượt quá một số nhất định.
- Thêm một nút IF IF vào quy trình làm việc của bạn và thiết lập điều kiện dựa trên dữ liệu của bạn.
Sử dụng webhooks
- Webhooks cho phép các ứng dụng gửi dữ liệu thời gian thực đến phiên bản N8N của bạn. Bạn có thể sử dụng tính năng này để kích hoạt quy trình công việc dựa trên các yêu cầu API đến.
- Thiết lập một nút webhook và sao chép URL được cung cấp. Định cấu hình dịch vụ bên ngoài của bạn để thực hiện yêu cầu đến URL đó khi xảy ra sự kiện.
Xử lý lỗi
- Việc thực hiện xử lý lỗi là rất quan trọng đối với quy trình công việc mạnh mẽ. Bạn có thể sử dụng trình kích hoạt lỗi tích hợp trên mạng để bắt lỗi và hướng chúng đến một nút cụ thể để ghi nhật ký hoặc mục đích thông báo.
Kiểm tra và triển khai
Giám sát quy trình công việc
- N8N cung cấp nhật ký thực thi toàn diện để giúp bạn khắc phục sự cố. Xem lại nhật ký trong giao diện trình soạn thảo N8N để biết thông tin chi tiết về mỗi lần chạy.
Lập kế hoạch quy trình công việc
- Bạn có thể sử dụng nút Cron Cron để lên lịch trình công việc theo các khoảng thời gian đã chỉ định, cho phép tự động hóa các tác vụ lặp đi lặp lại mà không cần sự can thiệp của người dùng.
Xuất khẩu quy trình công việc
- Khi quy trình làm việc của bạn hoàn tất, bạn có tùy chọn xuất nó dưới dạng JSON. Điều này cho phép bạn chia sẻ quy trình công việc của mình với người khác hoặc triển khai chúng đến các trường hợp N8N khác nhau.
Tài nguyên và cộng đồng
- Tài liệu chính thức: Luôn kiểm tra Tài liệu N8N Đối với các hướng dẫn chi tiết và cập nhật về các nút và tính năng.
- Diễn đàn cộng đồng: Tham gia với cộng đồng N8N thông qua Diễn đàn Để đặt câu hỏi và chia sẻ kinh nghiệm của bạn.
- Girub: Đóng góp hoặc khám phá mã và các vấn đề về Kho lưu trữ N8N GitHub.
Bằng cách làm theo các bước này, bạn có thể tích hợp API với N8N một cách hiệu quả để tự động hóa các tác vụ khác nhau, hợp lý hóa các quy trình và nâng cao năng suất trong các dự án của bạn. Hướng dẫn này phục vụ như một nền tảng mà có thể xây dựng các tích hợp phức tạp hơn, cho phép bạn khai thác toàn bộ tiềm năng của tự động hóa quy trình làm việc.