Bộ xử lý Cài đặt và Vận hành Tiện ích (Widget) Nhiệm vụ Bitrix24 - Quy trình làm việc n8n

Các nhà phát triển ứng dụng Bitrix24 cần backend đáng tin cậy để quản lý cài đặt và token.
Người dùng tìm kiếm các mẫu n8n mạnh mẽ cho các tương tác webhook phức tạp.
Các chuyên gia tự động hóa triển khai widget tùy chỉnh trong môi trường CRM.
Các kỹ sư tìm kiếm giải pháp tự lưu trữ (self-hosted) để xử lý API Bitrix24.

Việc phát triển các ứng dụng tùy chỉnh cho các nền tảng như Bitrix24 đòi hỏi việc xử lý phức tạp các token OAuth, callback cài đặt và phân phối nội dung động. Workflow n8n mạnh mẽ này giải quyết những thách thức đó bằng cách đóng vai trò là bộ xử lý trung tâm cho tất cả các sự kiện Bitrix24 liên quan đến ứng dụng widget tùy chỉnh của bạn. Giá trị chính của mẫu n8n này là khả năng quản lý liền mạch quá trình bắt tay cài đặt—lưu trữ các token truy cập quan trọng vào bộ nhớ—và sau đó sử dụng các thông tin xác thực được lưu trữ này trong thời gian chạy để truy xuất và hiển thị thông tin theo ngữ cảnh cụ thể (như chi tiết nhiệm vụ) trong tab xem nhiệm vụ của Bitrix
24.

Mỗi khi Bitrix24 gửi yêu cầu (dù là để cài đặt hay hiển thị widget), thiết lập nút n8n cụ thể này sẽ đảm bảo xác thực an toàn và phản hồi ngay lập tức, phù hợp, thể hiện hiệu quả của một luồng công việc n8n được thiết kế tốt.

Toàn bộ quy trình bắt đầu bằng nút kích hoạt n8n được chỉ định, nút Webhook, lắng nghe các yêu cầu POST từ Bitrix
24.

1. Kích hoạt và Khởi tạo: Bộ kích hoạt n8n Bitrix24 Handler nhận sự kiện. Nút n8n Extract Credentials ngay lập tức phân tích tải trọng JSON đến để truy xuất domain, access token và refresh token.


2. Xác định Sự kiện: Nút Code Check Event Type phân tích yêu cầu để phân biệt giữa sự kiện cài đặt ứng dụng (ONAPPINSTALL) và yêu cầu đặt widget thời gian chạy (ví dụ: xem nhiệm vụ).


3. Luồng Cài đặt: Nếu đó là cài đặt, workflow sẽ phân nhánh. Nếu việc cài đặt chưa hoàn tất, hệ thống sử dụng nút n8n Set Settings Data để định dạng các token, chuyển đổi chúng thành tệp JSON (Create Settings File), và lưu cấu hình bằng nút n8n Save Installation Settings (Read/Write File). Sau đó, nó đăng ký vị trí đặt widget (Register Placement HTTP Request) và hoàn tất quy trình bằng phản hồi webhook Installation Response.


4. Luồng Thời gian chạy (Hiển thị Widget): Nếu sự kiện là yêu cầu thời gian chạy, hệ thống sẽ truy xuất dữ liệu xác thực đã lưu trước đó bằng các nút n8n Read Installation Settings và Extract Installation Settings. Nút Merge request data with installation settings chuẩn bị ngữ cảnh dữ liệu cần thiết.


5. Xử lý và Truy xuất Dữ liệu: Nút Function Process Settings trích xuất thông tin theo ngữ cảnh cụ thể, chẳng hạn như taskId. Nút If Has Valid Settings? xác thực thông tin xác thực. Nếu hợp lệ, nút HTTP Request n8n Get Task Data sử dụng access token Bitrix24 đã lưu để truy vấn API Bitrix24 lấy thông tin nhiệm vụ chi tiết.


6. Tạo Phản hồi: Nút Function Format Task Data chuyển đổi dữ liệu nhiệm vụ thô thành HTML có cấu trúc. Cuối cùng, nút n8n Task View Response gửi HTML này trở lại Bitrix24, nơi nó được hiển thị trong widget nhiệm vụ tùy chỉnh. Nếu cài đặt không hợp lệ, thay vào đó sẽ trả về Error Response. Logic phức tạp này thể hiện ứng dụng mạnh mẽ của một workflow n8n.

Để triển khai luồng công việc n8n toàn diện này, hãy làm theo các bước sau:

1. Nhập Luồng công việc n8n: Sao chép dữ liệu JSON được cung cấp. Trong phiên bản n8n của bạn, điều hướng đến 'Workflows' và nhấp vào 'New'. Chọn 'Import from JSON' và dán mã.


2. Cấu hình Nút Kích hoạt Webhook: Tìm nút kích hoạt n8n Bitrix24 Handler. Đường dẫn được đặt là bitrix24/widgethandler.php. Kích hoạt luồng công việc để tạo URL webhook đầy đủ. URL này phải được đăng ký trong cài đặt ứng dụng Bitrix24 của bạn làm URL xử lý cho các sự kiện cài đặt và đặt vị trí.


3. Đặt Thông tin Xác thực Giữ chỗ: Nút n8n Extract Credentials chứa các giá trị giữ chỗ được mã hóa cứng (ví dụ: local.67b8a796e92127.82791242). Những giá trị này thường được ghi đè bởi dữ liệu trực tiếp từ Bitrix24 trong quá trình webhook cài đặt, nhưng bạn có thể cần điều chỉnh chúng nếu ứng dụng của bạn sử dụng Client ID/Secret tĩnh khác. Đảm bảo ứng dụng Bitrix24 của bạn được cấu hình đúng để gửi các token ban đầu này.


4. Truy cập Hệ thống Tệp: Luồng công việc sử dụng nút ReadWriteFile n8n để lưu và đọc các token xác thực Bitrix24. Đảm bảo môi trường máy chủ n8n của bạn có quyền cần thiết để truy cập đường dẫn /data/files/hotline_files/ (hoặc điều chỉnh biến settingsFilePath trong nút Extract Credentials thành vị trí có thể truy cập được bởi phiên bản n8n của bạn).


5. Kích hoạt: Lưu và kích hoạt luồng công việc n8n. Tự động hóa sẽ lắng nghe các sự kiện Bitrix24.

Bitrix24 Handler (Bộ kích hoạt Webhook n8n): Điểm vào của luồng công việc n8n. Nó được cấu hình để lắng nghe các yêu cầu POST tại một đường dẫn cụ thể, khởi tạo chuỗi các thao tác cho cả yêu cầu cài đặt và yêu cầu xem nhiệm vụ.
Extract Credentials (Nút Set n8n): Thiết yếu cho bảo mật, nút này trích xuất các tham số xác thực động (như accesstoken và refreshtoken) được gửi bởi Bitrix24, chuẩn bị chúng để sử dụng trong các yêu cầu HTTP tiếp theo và để lưu trữ.
Check Event Type (Nút Code n8n): Một nút kịch bản tùy chỉnh phân tích phần thân yêu cầu đến để phân biệt giữa callback cài đặt ứng dụng và các sự kiện đặt widget, cung cấp logic kiểm soát luồng quan trọng cho workflow n8n.
Is Installation? (Nút If n8n): Một nút n8n logic cốt lõi điều hướng luồng dựa trên việc yêu cầu hiện tại có phải là một phần của quá trình cài đặt ứng dụng hay không (isInstallation: true).
Set Settings Data & Save Installation Settings (Các nút Set & ReadWriteFile n8n): Các nút này hoạt động cùng nhau trong mẫu n8n để tuần tự hóa các token Bitrix24 mới nhận được (bao gồm thời gian hết hạn và domain) và ghi chúng một cách an toàn vào một tệp JSON trên hệ thống tệp cục bộ, đảm bảo tính bền vững cho việc sử dụng trong thời gian chạy sau này.
Register Placement (Nút HTTP Request n8n): Thực hiện một lệnh gọi API Bitrix24 để liên kết URL bộ xử lý widget tùy chỉnh với vị trí mong muốn, cụ thể là TASKVIEWTAB, đảm bảo URL webhook n8n được tích hợp chính xác vào giao diện Bitrix24.
Read Installation Settings & Process Settings (Các nút ReadWriteFile & Function n8n): Khi truy cập thời gian chạy, các nút này truy xuất và xử lý các token được lưu trữ, đảm bảo workflow n8n có các thông tin xác thực và ngữ cảnh cần thiết (như taskId cụ thể) để tiến hành tra cứu API.
Get Task Data (Nút HTTP Request n8n): Sử dụng các token truy cập đã được xác thực để thực hiện lệnh gọi được xác thực tới API Bitrix24 (tasks.task.get), truy xuất chi tiết cần thiết cho việc hiển thị widget. Đây là bước quan trọng trong giai đoạn thời gian chạy của workflow n8n này.

• Task View Response (Nút RespondToWebhook n8n): Hành động cuối cùng cho các yêu cầu thời gian chạy. Nó đóng gói HTML được tạo bởi nút Function trước đó và gửi trả lại ngay lập tức cho Bitrix24, hiển thị nội dung widget tùy chỉnh.