Ctrlk
Hỗ trợ trực tuyếnCác sản phẩm
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tích hợp dữ liệu từ hệ thống bên ngoài vào Salework Contact

Mục đích

Tính năng Tích hợp dữ liệu (Inbound Webhook) cho phép hệ thống bên ngoài (Website, Landing Page, CRM, Google Apps Script, Facebook Lead Form,...) gửi dữ liệu khách hàng trực tiếp vào Salework Contact thông qua Webhook URL.

Sau khi nhận dữ liệu, hệ thống sẽ:

  • Tự động tạo khách hàng mới.

  • Kiểm tra trùng theo số điện thoại.

  • Cập nhật dữ liệu nếu khách hàng đã tồn tại.

  • Đưa khách hàng vào đúng Kho dữ liệu và Quy trình đã cấu hình.

Điều kiện sử dụng

Người dùng cần có quyền quản trị hệ thống.

Chuẩn bị trước:

  • Đã tạo Kho dữ liệu.

  • Đã tạo Quy trình.

  • Có hệ thống có khả năng gửi HTTP POST (JSON).

Truy cập tính năng

Truy cập màn hình khách hàng -> Tích hợp

Màn hình hiển thị danh sách các cổng tích hợp đã tạo.

Tạo cổng tích hợp mới

Nhấn

Thêm mới Inbound

Hệ thống mở màn hình cấu hình.

Các thông tin cần khai báo:

Trường
Ý nghĩa

Quy trình áp dụng

Quy trình khách hàng sẽ tham gia sau khi được tạo

Tên cổng

Tên nhận diện webhook

Kho dữ liệu

Kho lưu khách hàng

Webhook URL

Địa chỉ để hệ thống ngoài gửi dữ liệu

Kiểm tra trùng

Kiểm tra theo số điện thoại trước khi tạo khách hàng

Kiểm tra trùng dữ liệu

Khi bật tùy chọn:

Kiểm tra trùng số điện thoại và tự động cập nhật vào dữ liệu gần nhất

Hệ thống sẽ:

  • tìm khách hàng theo SĐT

  • nếu chưa có → tạo mới

  • nếu đã tồn tại → cập nhật thông tin mới

Lưu ý:

Số điện thoại là trường định danh chính của dữ liệu khách hàng.

Thiết lập dữ liệu mẫu lần đầu

Sau khi tạo webhook, cần gửi một payload mẫu từ hệ thống ngoài để Salework Contact nhận diện các trường dữ liệu.

Có thể:

  • Dán trực tiếp JSON mẫu

  • Hoặc chọn Push dữ liệu mẫu

Sau khi hệ thống đọc dữ liệu, các key sẽ xuất hiện để thực hiện Mapping.

Ví dụ dữ liệu mẫu:

Mapping dữ liệu

Sau khi đọc JSON mẫu, hệ thống sẽ hiển thị:

  • Danh sách trường của Salework Contact

  • Danh sách key nhận được từ payload

Người dùng chọn trường tương ứng.

Ví dụ:

Trường Salework
Key nhận từ Webhook

Họ và tên

name

Số điện thoại

phone

Email

email

Ghi chú

message

Các trường không cần sử dụng có thể bỏ trống.

Kích hoạt cổng tích hợp

Sau khi hoàn tất Mapping

Nhấn

Kích hoạt cổng

Webhook sẽ sẵn sàng tiếp nhận dữ liệu.

Ví dụ luồng hoạt động

Website │ │ Submit Form ▼ Google Apps Script │ │ HTTP POST ▼ Webhook URL Salework Contact │ ▼ Kiểm tra trùng SĐT │ ┌────────┐ │ │ Có Không │ │ Cập nhật Tạo khách hàng │ ▼ Đưa vào Kho dữ liệu │ ▼ Tham gia Quy trình

Payload tối thiểu khuyến nghị

Để tạo khách hàng thành công, nên gửi tối thiểu:

{ "name":"Nguyễn Văn A", "phone":"0987654321" }

Khuyến nghị bổ sung:

{ "name":"Nguyễn Văn A", "phone":"0987654321", "email":"abc@gmail.com", "message":"Khách hàng quan tâm gói Premium", "utm_source":"facebook", "utm_campaign":"sale2025", "url_page":"https://landingpage.com", "ip":"222.252.23.45" }

Ví dụ tích hợp Google Form bằng Apps Script

Ví dụ một Google Form thu thập các trường:

  • Họ và tên

  • Số điện thoại

  • Facebook/Zalo/TikTok

  • Tên Shop

  • Ngành hàng

  • Nhu cầu

  • Quy mô

  • Thời gian tư vấn

  • Ghi chú

Apps Script chỉ cần Mapping tại một nơi để dễ bảo trì.

Ưu điểm của cách triển khai này:

  • Chỉ cần sửa FIELD_MAP khi thay đổi tên key hoặc bổ sung trường mới.

  • Không phải sửa logic xử lý hoặc gửi webhook.

  • Dễ mở rộng khi Salework Contact bổ sung thêm trường dữ liệu trong tương lai.

Last updated