Tích hợp (Integration)
Mục đích
Phần tiêu đề “Mục đích”Bước Tích hợp (Integration) kết nối quy trình với tài khoản bên ngoài đã được liên kết (ví dụ: HubSpot) và thực hiện một trong ba thao tác: Upsert (tạo mới hoặc cập nhật bản ghi), Get (đọc một bản ghi theo trường khớp), hoặc Search (tìm kiếm nhiều bản ghi theo bộ lọc). Kết quả đọc được lưu vào một biến trong quy trình để các bước sau sử dụng.
Khi nào dùng
Phần tiêu đề “Khi nào dùng”- Sau khi người dùng điền biểu mẫu đề xuất mua sắm, tự động cập nhật deal trong HubSpot với thông tin ngân sách và trạng thái.
- Trước bước Trợ lý AI (Agent), tra cứu thông tin khách hàng từ hệ thống CRM để cung cấp ngữ cảnh cho mô hình.
- Sau bước Ký tên (Signature), tìm kiếm bản ghi liên hệ để gắn tài liệu đã ký vào hồ sơ tương ứng.
Cài đặt chính
Phần tiêu đề “Cài đặt chính”| Trường | Mô tả |
|---|---|
| Nhà cung cấp (Provider) | Hệ thống bên ngoài cần kết nối, ví dụ hubspot. Danh sách lấy từ các tích hợp đã đăng ký trong tổ chức. |
| Tài khoản (Account) | Tài khoản cụ thể đã kết nối với nhà cung cấp. Một tổ chức có thể liên kết nhiều tài khoản của cùng một nhà cung cấp. |
| Thao tác (Operation) | Upsert — ghi dữ liệu; Get — đọc một bản ghi; Search — tìm nhiều bản ghi theo bộ lọc. |
| Loại đối tượng (Object type) | Kiểu bản ghi của nhà cung cấp, ví dụ: Contact, Deal, Company (với HubSpot). |
| Trường khớp (Match field) | Trường dùng để xác định bản ghi (dành cho Upsert và Get), ví dụ email. Nếu bản ghi đã tồn tại thì cập nhật; nếu chưa thì tạo mới (Upsert). |
| Ánh xạ trường (Field mappings) | Danh sách trường nhà cung cấp ← giá trị. Mỗi hàng chọn tên trường và gán giá trị từ biến quy trình, template {{ }}, hoặc giá trị cố định. Dành cho Upsert. |
| Bộ lọc (Filters) | Các điều kiện tìm kiếm cho thao tác Search: chọn trường, toán tử (là, không là, chứa, bắt đầu bằng, lớn hơn, nhỏ hơn, đã biết, chưa biết) và giá trị so sánh. |
| Liên kết bản ghi (Associations) | Tùy chọn: gắn kết bản ghi với đối tượng liên quan, ví dụ liên kết Deal với Contact theo ID. |
| Lưu kết quả vào (Capture to) | Tên biến lưu kết quả đọc để bước sau tham chiếu, ví dụ contact_data. Chỉ áp dụng cho Get và Search. |
| Trường hiển thị được (Safe fields) | Danh sách trường trong kết quả đọc mà người dùng không có quyền instance.admin được phép xem. Các trường không chọn sẽ bị che. |
Ví dụ
Phần tiêu đề “Ví dụ”Trong quy trình Đề xuất mua sắm, bước Tích hợp đặt sau bước ký tên để cập nhật deal trong HubSpot:
| Trường cài đặt | Giá trị |
|---|---|
| Nhà cung cấp | HubSpot |
| Tài khoản | Tài khoản kinh doanh chính |
| Thao tác | Upsert |
| Loại đối tượng | Deal |
| Trường khớp | email |
| Ánh xạ trường | dealname ← {{ nodes.start.output.ten_du_an }} |
amount ← {{ nodes.start.output.gia_tri_hop_dong }} |
|
dealstage ← closedwon (giá trị cố định) |
Kết quả: khi hợp đồng được ký, deal trong HubSpot tự động chuyển trạng thái và cập nhật giá trị — không cần nhập tay.
Để tra cứu thông tin khách hàng trước khi trợ lý AI soạn email, thêm bước Tích hợp với thao tác Get, lưu vào biến khach_hang, rồi dùng {{ nodes.buoc_tich_hop.output.khach_hang.properties.firstname }} trong prompt của bước Trợ lý AI.
Xem thêm tổng quan quy trình tại Tổng quan quy trình.