Tích Hợp Dữ Liệu

Đồng bộ dữ liệu cộng đồng với bảng tính, công cụ CRM và dịch vụ bên ngoài. Các tích hợp này hoạt động như nút hành động trong Workflow Builder.

Tổng Quan

Dịch Vụ	Thao Tác	Phương Thức Xác Thực
Google Sheets	Thêm hàng, cập nhật ô, cập nhật hàng, đọc hàng, tra cứu hàng, xóa vùng	Service Account hoặc OAuth2
HubSpot	Tạo/cập nhật contact, tạo deal, thêm/xóa khỏi list	OAuth2 hoặc Private App Token
Mailchimp	Đăng ký/hủy đăng ký, thêm/xóa tag	API key
Kit (ConvertKit)	Đăng ký/hủy đăng ký, thêm/xóa tag	API key
Webhook	HTTP POST/PUT tùy chỉnh đến bất kỳ URL nào	Bearer token, API key, hoặc header tùy chỉnh

Google Sheets

Thiết Lập

Cách 1: Service Account (khuyến nghị)

Truy cập Google Cloud Console
Tạo project → Bật Google Sheets API
Vào Credentials → Tạo Service Account
Tải xuống file JSON key
Mở bảng tính → nhấn Share → thêm email service account (ví dụ: my-bot@project.iam.gserviceaccount.com) với quyền Editor

Cách 2: OAuth2

Trong Uni8, nhấn Connect và đăng nhập bằng tài khoản Google
Cấp quyền truy cập Google Sheets

Trong Uni8:

Vào Settings > Automations > Integrations > Google Sheets
Tải lên file JSON key (Service Account) hoặc nhấn Connect (OAuth2)
Nhấn Test Connection

Hành Động

Thêm Hàng

Thêm một hàng mới vào cuối bảng tính. Phù hợp để ghi nhận sự kiện, đăng ký hoặc giao dịch.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID từ URL bảng tính	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms`
Sheet Name	Tên tab trong bảng tính	`Sheet1`
Columns	Giá trị cho mỗi cột, mỗi dòng một giá trị	Xem bên dưới

Giá trị cột — Nhập mỗi giá trị trên một dòng. Mỗi dòng tương ứng với một cột (A, B, C, ...):

{{ user.name }}
{{ user.email }}
{{ triggerPayload.membershipTier }}
{{ triggerPayload.amount }}

Kết quả tạo ra một hàng: | John Doe | john@example.com | Pro | 500000 |

Hỗ trợ tối đa 50 cột mỗi hàng.

Cập Nhật Ô

Chỉnh sửa một vùng ô cụ thể. Phù hợp để cập nhật dashboard, trường trạng thái hoặc bảng tổng hợp.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID bảng tính từ URL	`1BxiMVs0XRA...`
Range	Vùng ô theo ký hiệu A1	`Sheet1!B2:D2`
Values	Giá trị mới, mỗi dòng một giá trị	Xem bên dưới

Ví dụ — Cập nhật trạng thái thành viên:

Range: Members!C5:E5
Values:

Active
2025-01-15
Pro Tier

Cập Nhật Hàng

Tìm một hàng bằng cách khớp giá trị cột, sau đó cập nhật các ô cụ thể trong hàng đó.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID bảng tính từ URL	`1BxiMVs0XRA...`
Sheet Name	Tên tab	`Members`
Lookup Column	Cột để tìm kiếm (A, B, C...)	`A`
Lookup Value	Giá trị cần khớp	`{{ user.email }}`
Update Columns	Cặp cột-giá trị cần cập nhật	Xem bên dưới

Ví dụ — Cập nhật hạng thành viên khi thay đổi gói:

Lookup Column: A (cột email)
Lookup Value: {{ user.email }}
Cập nhật: Column C = {{ triggerPayload.newTier }}, Column D = {{ triggerPayload.date }}

Đọc Hàng

Đọc dữ liệu từ một vùng. Hữu ích để kiểm tra dữ liệu hiện có trước khi ghi.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID bảng tính từ URL	`1BxiMVs0XRA...`
Range	Vùng ô cần đọc	`Sheet1!A1:D100`

Trả về dữ liệu hàng có thể được sử dụng trong các nút workflow tiếp theo.

Tra Cứu Hàng

Tìm kiếm một hàng cụ thể bằng cách khớp giá trị trong một cột. Trả về hàng khớp đầu tiên.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID bảng tính từ URL	`1BxiMVs0XRA...`
Sheet Name	Tên tab	`Members`
Lookup Column	Cột để tìm kiếm	`B`
Lookup Value	Giá trị cần tìm	`{{ user.email }}`

Xóa Vùng

Xóa tất cả giá trị trong một vùng ô mà không xóa các ô.

Cấu hình:

Trường	Mô Tả	Ví Dụ
Spreadsheet ID	ID bảng tính từ URL	`1BxiMVs0XRA...`
Range	Vùng ô cần xóa	`Sheet1!A2:Z1000`

Trường Hợp Sử Dụng Phổ Biến

Trường Hợp	Hành Động	Ví Dụ
Ghi nhận thành viên mới	Thêm Hàng	Tên, email, ngày tham gia, hạng
Theo dõi tham dự sự kiện	Thêm Hàng	Tên, tiêu đề sự kiện, thời gian check-in
Cập nhật trạng thái thành viên	Cập Nhật Hàng	Tìm theo email, cập nhật cột hạng
Xuất bản ghi thanh toán	Thêm Hàng	Số tiền, ngày, sản phẩm, người mua
Dashboard báo cáo hàng tháng	Cập Nhật Ô	Cập nhật ô tổng hợp với số liệu tổng

HubSpot CRM

Thiết Lập

OAuth2 (khuyến nghị):

Trong Uni8, nhấn Connect và cấp quyền với HubSpot

Private App Token:

Truy cập HubSpot Developers
Tạo Private App với các scope: crm.objects.contacts.write, crm.objects.deals.write, crm.lists.write
Sao chép access token

Hành Động

Tạo/Cập Nhật Contact

Tạo hoặc cập nhật contact theo địa chỉ email
Ánh xạ các trường hồ sơ cộng đồng sang thuộc tính contact HubSpot
Hỗ trợ thuộc tính tùy chỉnh

Trường	Ánh Xạ Đến
`{{ user.email }}`	Email (khóa tra cứu)
`{{ user.name }}`	Họ/Tên
`{{ triggerPayload.membershipTier }}`	Thuộc tính tùy chỉnh

Tạo Deal

Tạo deal trong pipeline và giai đoạn cụ thể
Gắn với contact hiện có
Đặt số tiền, tên deal và ngày đóng

Thêm/Xóa Khỏi List

Thêm hoặc xóa contact khỏi static list
Hữu ích để phân nhóm thành viên theo hạng, tham dự sự kiện hoặc hoàn thành khóa học

Mailchimp

Thiết Lập

Vào Mailchimp Account Settings > API Keys
Tạo API key mới
Trong Uni8, dán key — datacenter được tự động phát hiện từ hậu tố key

Hành Động

Đăng ký — Thêm hoặc cập nhật thành viên trong audience (upsert theo email)
Hủy đăng ký — Xóa thành viên khỏi audience
Thêm tag — Gắn tag cho subscriber để phân nhóm
Xóa tag — Xóa tag khỏi subscriber

Hỗ trợ merge field tùy chỉnh cho dữ liệu hồ sơ bổ sung.

Kit (ConvertKit)

Thiết Lập

Vào Kit Settings > Developer và sao chép API key
Trong Uni8, dán API key

Hành Động

Đăng ký — Thêm subscriber (upsert theo email)
Hủy đăng ký — Xóa subscriber
Thêm tag — Gắn tag cho subscriber
Xóa tag — Xóa tag

Hỗ trợ trường tùy chỉnh.

Webhook (Tùy Chỉnh)

Gửi dữ liệu đến bất kỳ URL bên ngoài nào khi workflow chạy. Lý tưởng để kết nối các dịch vụ chưa có tích hợp sẵn.

Thiết Lập

Không cần thông tin xác thực — cấu hình trực tiếp trong mỗi hành động của workflow.

Cấu Hình

Trường	Mô Tả
URL	Endpoint HTTPS nhận dữ liệu
Method	POST hoặc PUT
Headers	Header tùy chỉnh (ví dụ: Authorization, Content-Type)
Body Template	Body JSON với biểu thức `{{ }}`
Retry Count	0–5 lần thử lại với exponential backoff

Ví Dụ Body Template

{
  "event": "membership_purchased",
  "member": {
    "name": "{{ user.name }}",
    "email": "{{ user.email }}"
  },
  "tier": "{{ triggerPayload.membershipTier }}",
  "amount": "{{ triggerPayload.amount }}"
}

Tính Năng Bảo Mật

Chỉ HTTPS — URL HTTP bị chặn
Ký HMAC-SHA256 — Mỗi tenant có một signing secret riêng. Chữ ký được gửi trong header X-Webhook-Signature để xác minh payload
Chống SSRF — Địa chỉ IP nội bộ/riêng tư bị chặn
Timeout — Timeout 10 giây mỗi lần thử
Thử lại — Exponential backoff (1s, 2s, 4s, 8s, 16s) tối đa 5 lần thử lại

Làm Giàu Payload

Payload webhook được tự động bổ sung thông tin ngữ cảnh dựa trên trigger:

Dữ liệu người dùng — Tên, email, trường hồ sơ
Dữ liệu sự kiện — Tiêu đề sự kiện, ngày, địa điểm (cho trigger sự kiện)
Dữ liệu khóa học — Tiêu đề khóa học, trạng thái hoàn thành (cho trigger khóa học)
Dữ liệu thanh toán — Số tiền, đơn vị tiền tệ, ID giao dịch (cho trigger thanh toán)

Liên Quan

Thiết Lập Tích Hợp — Tổng quan quản lý thông tin xác thực
Tích Hợp Nhắn Tin — Discord, Twilio, Slack và nhiều hơn
Workflow Builder — Xây dựng workflow tự động

Tổng Quan​

Google Sheets​

Thiết Lập​

Hành Động​

Thêm Hàng​

Cập Nhật Ô​

Cập Nhật Hàng​

Đọc Hàng​

Tra Cứu Hàng​

Xóa Vùng​

Trường Hợp Sử Dụng Phổ Biến​

HubSpot CRM​

Thiết Lập​

Hành Động​

Mailchimp​

Thiết Lập​

Hành Động​

Kit (ConvertKit)​

Thiết Lập​

Hành Động​

Webhook (Tùy Chỉnh)​

Thiết Lập​

Cấu Hình​

Ví Dụ Body Template​

Tính Năng Bảo Mật​

Làm Giàu Payload​

Liên Quan​

Tổng Quan

Google Sheets

Thiết Lập

Hành Động

Thêm Hàng

Cập Nhật Ô

Cập Nhật Hàng

Đọc Hàng

Tra Cứu Hàng

Xóa Vùng

Trường Hợp Sử Dụng Phổ Biến

HubSpot CRM

Thiết Lập

Hành Động

Mailchimp

Thiết Lập

Hành Động

Kit (ConvertKit)

Thiết Lập

Hành Động

Webhook (Tùy Chỉnh)

Thiết Lập

Cấu Hình

Ví Dụ Body Template

Tính Năng Bảo Mật

Làm Giàu Payload

Liên Quan