Hướng Dẫn Chi Tiết: Webhooks trong N8N (Từ Người Mới Bắt Đầu Đến Chuyên Gia)

Giới Thiệu Webhooks trong N8N

Webhooks trong N8N có thể cực kỳ mạnh mẽ, nhưng nhiều người vẫn chưa hiểu rõ cách chúng hoạt động. Bài viết này sẽ hướng dẫn bạn từng bước, từ cơ bản đến nâng cao, để bạn có thể làm chủ và tận dụng tối đa sức mạnh của webhooks trong N8N. Chúng ta sẽ cùng tìm hiểu webhooks là gì, cách chúng hoạt động, và cách bạn có thể sử dụng chúng để kết nối các ứng dụng và tự động hóa quy trình làm việc của mình.

Webhooks Là Gì?

Để đơn giản hóa, hãy hiểu rằng webhooks là những tin nhắn. Chúng được định dạng một cách rõ ràng và gửi giữa các ứng dụng. Ví dụ:

• Ứng dụng A gửi tin nhắn đến ứng dụng B.
• Ứng dụng B gửi tin nhắn đến ứng dụng A.

Tin nhắn này chứa dữ liệu cụ thể và được định dạng theo một cách nhất định để ứng dụng nhận có thể hiểu và xử lý. Hãy tưởng tượng bạn gặp bạn của mình và nói: “Tôi vừa thấy Stacy ở cửa hàng!” Đó chính là một webhook. Bạn đang gửi một tin nhắn (dữ liệu) đến bạn của mình.

Ví Dụ Thực Tế Về Webhooks

Để làm cho khái niệm này trở nên thực tế hơn, đặc biệt là trong bối cảnh các công cụ no-code và low-code được sử dụng cho mục đích kinh doanh, hãy xem xét một ví dụ:

Giả sử ứng dụng A là một trình quản lý email (ví dụ: Gmail, Outlook). Khi bạn nhận được một email mới, trình quản lý email này sẽ gửi một webhook đến ứng dụng B, là hệ thống CRM (Quản lý quan hệ khách hàng) của bạn. Mục đích là để thêm dữ liệu từ email mới vào CRM.

Quy trình này hoạt động như sau:

1. Bạn nhận được một email mới.
2. Trình quản lý email của bạn gửi một webhook đến CRM.
3. CRM của bạn thêm một bản ghi mới chứa thông tin từ email (ví dụ: địa chỉ email, tên, họ).

Webhooks chỉ là các gói dữ liệu nhỏ được gửi qua lại giữa các ứng dụng. Chúng trở nên phổ biến trong những năm 2020 vì chúng cho phép chúng ta tích hợp các ứng dụng khác nhau một cách dễ dàng. Các công cụ no-code và low-code giúp “dán” các nền tảng khác nhau lại với nhau, và webhooks là một phần quan trọng của quá trình này.

Webhooks Trong N8N

N8N cung cấp hai cách chính để làm việc với webhooks:

• Bắt Webhook (Catch a Webhook): Nhận tin nhắn đến bằng cách sử dụng node “Webhook”.
• Phản Hồi Webhook (Respond to Webhook): Gửi dữ liệu từ N8N đến nguồn gửi webhook ban đầu.

Hai chức năng này là cốt lõi của cách internet hoạt động và là một trong những lý do khiến N8N trở nên mạnh mẽ. Chúng cho phép bạn dễ dàng kết nối với bất kỳ ứng dụng nào, ngay cả khi ứng dụng đó không có tích hợp sẵn.

Tại Sao Webhooks Quan Trọng?

Mặc dù N8N cung cấp hàng trăm “actions” (hành động), nhưng số lượng ứng dụng trên internet còn lớn hơn nhiều. Webhooks cho phép bạn tích hợp với những ứng dụng không có actions sẵn có. Chúng cung cấp một cách tùy chỉnh để kết nối các ứng dụng khác nhau.

Cách Webhooks Hoạt Động Trong N8N

Trong N8N, bạn sử dụng node “Webhook” để tạo và quản lý webhooks. Node này tạo ra một URL tùy chỉnh mà bạn có thể sử dụng để gửi và nhận dữ liệu.

Ví dụ, nếu bạn đang sử dụng N8N Cloud, URL của bạn có thể trông như thế này: https://n8n.app/webhook/YOUR_UNIQUE_ID. Nếu bạn đang sử dụng phiên bản tự lưu trữ (self-hosted) của N8N, URL sẽ khác một chút.

Bằng cách tạo node Webhook, bạn đã tạo ra một “khối Lego” nhỏ mà bạn có thể sử dụng để kết nối với các “khối Lego” khác và mở rộng khả năng tự động hóa của mình.

Các Trường Quan Trọng Trong Node Webhook

• Test URL vs. Production URL:
  • Test URL: Sử dụng trước khi workflow của bạn hoạt động chính thức.
  • Production URL: Sử dụng khi workflow của bạn đã sẵn sàng để triển khai vào thực tế.
  • Điểm khác biệt chính là webhook-test trong Test URL sẽ được thay thế bằng webhook trong Production URL.
• Path: Bạn có thể tùy chỉnh đường dẫn (path) của URL webhook. Ví dụ: /my-super-cool-webhook-listener.
• HTTP Method: Xác định phương thức HTTP mà webhook sẽ phản hồi (ví dụ: GET, POST, PUT, DELETE). Phổ biến nhất là GET và POST.
  • GET: Yêu cầu dữ liệu từ một tài nguyên được chỉ định.
  • POST: Gửi dữ liệu đến một máy chủ để tạo hoặc cập nhật một tài nguyên.
• Authentication: Thiết lập xác thực để chỉ cho phép những người có “mật khẩu” bí mật mới có thể kích hoạt webhook.
  • N8N mặc định sử dụng xác thực, nhưng bạn có thể tắt nó.
  • Các phương pháp xác thực bao gồm Basic Auth, Header Auth, JSON Web Token (JWT) Auth, v.v.
• Respond: Xác định cách N8N sẽ phản hồi khi nhận được yêu cầu webhook.
  • Immediately: Phản hồi ngay lập tức khi nhận được yêu cầu.
  • When the last node finishes: Chờ đến khi node cuối cùng trong workflow hoàn thành trước khi phản hồi.
  • Using the “Respond to Webhook” node: Sử dụng node “Respond to Webhook” để tùy chỉnh phản hồi.
• Options: Các tùy chọn bổ sung, chẳng hạn như bỏ qua bot (ignore Bots) và tùy chỉnh mã phản hồi (Response Code).

Kích Hoạt Webhook

Một điều mà nhiều người không biết là bạn có thể kích hoạt webhook bằng cách truy cập URL của nó trong trình duyệt. Đây là cách đơn giản nhất để kiểm tra webhook.

Ví dụ, bạn có thể sao chép URL webhook, lắng nghe một sự kiện thử nghiệm (test event) và dán URL vào một tab mới trong trình duyệt của bạn. Bạn sẽ nhận được một tin nhắn JSON cho biết workflow đã được bắt đầu.

Khi bạn quay lại tab N8N, bạn sẽ thấy dữ liệu đầu ra, bao gồm:

• Headers: Dữ liệu từ trình duyệt của bạn (ví dụ: loại máy tính, trình duyệt, user agent, các loại dữ liệu được chấp nhận, cookie, địa chỉ IP).
• Params: Tham số (parameters) được gửi trong URL.
• Query: Các biến được thêm vào cuối URL (ví dụ: ?firstName=Nick).
• Body: Dữ liệu được gửi trong phần thân (body) của yêu cầu.
• Webhook URL: URL của webhook.
• Execution Mode: Cho biết webhook đang ở chế độ test hay production.

Gửi Dữ Liệu Đến Webhook

Có nhiều cách để gửi dữ liệu đến webhook:

• Query Parameters: Thêm các biến vào cuối URL bằng dấu chấm hỏi (?) và dấu bằng (=) (ví dụ: ?firstName=Nick&lastName=Saraf).
• Dynamic Paths: Sử dụng các đường dẫn động trong URL để truyền dữ liệu (ví dụ: /firstName/Nick/lastName/Saraf).
• Sử Dụng Terminal (Curl Request): Sử dụng lệnh curl trong terminal để gửi yêu cầu GET hoặc POST.
• Sử Dụng N8N Workflow Khác (HTTP Request): Gửi yêu cầu HTTP từ một workflow N8N đến một workflow N8N khác.

Sử dụng N8N để gửi yêu cầu đến các workflow N8N khác là một cách tuyệt vời để tạo ra kiến trúc phức tạp và các quy trình làm việc song song.

Phản Hồi Webhook

Thay vì chỉ nhận được tin nhắn “Workflow was started”, bạn có thể gửi dữ liệu trở lại nguồn đã gửi webhook. Điều này cho phép bạn xây dựng các API (Application Programming Interfaces) và tạo ra các ứng dụng phức tạp hơn.

Sử Dụng Node “Respond to Webhook”

Để bật chức năng này, hãy sử dụng node “Respond to Webhook” và chọn “Using webhook to respond to webhook node”.

Các Tùy Chọn Phản Hồi

• All Incoming Items: Trả lại tất cả dữ liệu đã được gửi đến webhook. Đây là một cách tuyệt vời để kiểm tra webhook và đảm bảo bạn đang gửi và nhận đúng dữ liệu.
• Binary File: Phản hồi bằng dữ liệu nhị phân (binary). Thường ít được sử dụng.
• First Incoming Item: Chỉ phản hồi với mục (item) đầu tiên trong một yêu cầu chứa nhiều mục.
• JSON: Xác định JSON mà bạn muốn gửi lại. Ví dụ: {"message": "What's up loser!"}. Bạn có thể sử dụng các hàm để thao tác với dữ liệu trước khi gửi nó trở lại.
• JSON Web Token (JWT): Sử dụng JWT để xác thực và ủy quyền.
• No Data: Không phản hồi gì cả.
• Redirect: Chuyển hướng yêu cầu đến một URL khác.
• Text: Phản hồi bằng văn bản thuần túy.

Phản Hồi Bằng HTML (Text/HTML)

Giá trị thực sự của việc phản hồi bằng văn bản là bạn có thể gửi HTML. Điều này cho phép bạn xây dựng toàn bộ trang web và phục vụ nó cho những người truy cập.

Bạn có thể tạo các trang HTML tùy chỉnh và chèn dữ liệu động vào trang. Điều này mở ra nhiều ứng dụng hướng đến khách hàng, chẳng hạn như:

• Hiển thị dữ liệu từ CRM hoặc email.
• Tạo các trang tổng quan (dashboards) tùy chỉnh.
• Cho phép người dùng thao tác với dữ liệu trực tiếp trên trang web.

Ví Dụ: Tạo Trang HTML Tùy Chỉnh

Bạn có thể sử dụng HTML để tạo một trang web đơn giản hiển thị tên người dùng:

    <html>
    <head>
      <title>Chào mừng!</title>
    </head>
    <body>
      <h1>Xin chào, [TÊN_NGƯỜI_DÙNG]!</h1>
      <p>Chào mừng đến với trang web của chúng tôi!</p>
    </body>
    </html>
  

Sau đó, bạn có thể sử dụng JavaScript để thay thế [TÊN_NGƯỜI_DÙNG] bằng tên thực tế của người dùng.

Xác Thực (Authentication)

Xác thực là một cách để bảo vệ webhooks của bạn khỏi truy cập trái phép. Bạn có thể yêu cầu người dùng cung cấp tên người dùng và mật khẩu hoặc API key để truy cập webhook.

Các Phương Pháp Xác Thực Phổ Biến

• Basic Auth: Yêu cầu tên người dùng và mật khẩu.
• Header Auth: Yêu cầu API key trong header của yêu cầu.
• JSON Web Token (JWT) Auth: Sử dụng JWT để xác thực.

Ví Dụ: Sử Dụng Header Auth

Để sử dụng Header Auth, bạn cần cung cấp một tên header (ví dụ: API-Key) và một giá trị (ví dụ: password). Sau đó, bất kỳ ai muốn truy cập webhook cần phải bao gồm header này trong yêu cầu của họ.

Tự Lưu Trữ (Self-Hosting) và Localhost

Nếu bạn đang tự lưu trữ N8N bằng Docker hoặc các cơ chế khác, bạn có thể cần phải định cấu hình một số cài đặt để webhooks hoạt động chính xác.

Định Cấu Hình Biến Môi Trường (Environment Variables)

Đảm bảo rằng bạn đã đặt biến môi trường WEBHOOK_URL thành URL gốc của phiên bản N8N của bạn.

Reverse Proxy (Nginx)

Trong một số trường hợp, bạn có thể cần thiết lập một reverse proxy (ví dụ: Nginx) để định tuyến các yêu cầu đến phiên bản N8N của bạn. Nginx là một máy chủ web mã nguồn mở phổ biến mà bạn có thể sử dụng để chuyển tiếp các yêu cầu đến N8N.

Kết Luận

Webhooks là một công cụ mạnh mẽ cho phép bạn kết nối các ứng dụng và tự động hóa quy trình làm việc của mình. Bằng cách hiểu cách webhooks hoạt động trong N8N, bạn có thể xây dựng các ứng dụng phức tạp và tùy chỉnh để đáp ứng nhu cầu cụ thể của mình. Hãy thử nghiệm với các ví dụ trong bài viết này và khám phá những khả năng vô tận mà webhooks mang lại!

Nếu bạn có bất kỳ câu hỏi nào, đừng ngần ngại để lại bình luận bên dưới. Hãy nhớ đăng ký kênh của chúng tôi để nhận thêm các hướng dẫn và mẹo hữu ích về N8N và các công cụ no-code/low-code khác.

Chúc các bạn thành công!