# Tích hợp hệ thống CHAT Subiz

Đối với hệ thống chat Subiz, HUB Platform hỗ trợ doanh nghiệp đồng bộ các thông tin contact về hệ thống CDP. Quy trình tích hợp dữ liệu khách hàng từ Subiz về CDP HUB gồm các bước như sau. 

## <mark style="color:blue;">1. Tạo mới Webhook trên hệ thống Subiz</mark>

Webhook là một cơ chế cho phép ứng dụng gửi thông báo tới một URL khi có sự kiện xảy ra. Đơn giản là một cơ chế cho phép tự động thông báo và phản hồi giữa các hệ thống khi có sự kiện xảy ra.

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Truy cập vào Webhook trên Subiz</mark>

Trên thanh menu bên trên của hệ thống Subiz, chọn **Cài đặt** -> chọn **Webhook** ở thanh menu bên phải (thuốc nhóm **Tích hợp**).&#x20;

<figure><img src="/files/zPGxDJXeZkUgVjQRKJtu" alt=""><figcaption></figcaption></figure>

Chuyển sang màn hình quản lý Webhook.
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Tạo Webhook</mark>

Nhấn vào nút ![](/files/yKc6NWas0dW6ivJZPUTK).&#x20;

Tại màn hình tạo mới webhook, bạn cần điền các thông tin quan trọng sau:

* **Địa chỉ URL:** bạn cần nhập đường dẫn URL được sử dụng để nhận dữ liệu (URL này là đường dẫn đến đích webhook - nơi nhận và xử lý dữ liệu được gửi đến).&#x20;

{% hint style="info" %}
Địa chỉ URL được nhập theo format sau: **URL CDP/subiz/webhook**
{% endhint %}

* **Mật khẩu:** bạn có thể mật khẩu nếu cần thiết hoặc không cần nhập
* **"Bạn muốn webhook này nhận những sự kiện nào?"**: chọn "Chỉ những sự kiện thay đổi thông tin người dùng"

{% hint style="info" %}
***Cơ chế hoạt động và đồng bộ thông tin khách hàng:***

* **Đối với tạo mới contact:**
  * Contact sẽ được tạo mới khi trường tuỳ chỉnh **phone** hoặc **email** không trống.
* **Đối với cơ chế update contact:**
  * Nếu contact có thay đổi một trong các trường thông tin sau: **birth\_day; phone; email; address; deal\_note**
    {% endhint %}

Hãy bật nút xanh "Sử dụng" để doanh nghiệp có thể sử dụng webhook này để gửi và nhận các sự kiện phát sinh.

<figure><img src="/files/hV6QYDnbwnmHL5JtpDxz" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Lưu Webhook</mark>

Chọn **Tạo Webhook** để lưu thao tác tạo mới webhook

<figure><img src="/files/R51uuJERJG5VvIKseYa6" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

Tiếp theo, doanh nghiệp cần kết nối Webhook vừa tạo của Subiz với hệ thống CDP HUB Platform.

## <mark style="color:blue;">2. Kết nối trên hệ thống CDP</mark>

3 bước đơn giản để kết nối Subiz và CDP HUB Platform:

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Truy cập plugin Subiz</mark>

* **Truy cập Quản lý Plugin**

Trên giao diện hệ thống CDP, chọn biểu tượng **Cài đặt -> Quản lý nền tảng -> Plugin** để vào màn hình danh sách các Plugin.

<figure><img src="/files/dIk1zRMu0uhqMuI523xK" alt=""><figcaption></figcaption></figure>

* **Chọn Plugin Subiz**

Bạn có thể chọn plugin trên màn hình danh sách, hoặc gõ "Subiz" vào thanh tìm kiếm để lọc và chọn plugin Subiz.&#x20;

<figure><img src="/files/SYB8pVj3vBVy1r0GElsN" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Thông tin chi tiết</mark>

Trên cửa sổ kết nối Subiz, bạn cần thao tác nhập các thông tin như sau:

* **Stage mặc định của khách hàng:** Nhập stage doanh nghiệp muốn gán cho khách hàng khi được đồng bộ từ hệ thống Subiz về.

-> **Xuất bản:** Chọn yes để kích hoạt plugin Subiz.

<figure><img src="/files/YHTN7axwxxBmE6byohOd" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}
Chọn **Lưu** hoặc **Lưu & Đóng** để lưu thao tác kết nối.
{% endtab %}
{% endtabs %}

## <mark style="color:blue;">**3. Cấu hình nguồn đến của contact trên hệ thống CDP**</mark> <a href="#cau-hinh-funnel-tren-contact" id="cau-hinh-funnel-tren-contact"></a>

Hệ thống chat Subiz hỗ trợ doanh nghiệp đón cuộc chat của khách hàng từ nhiều nguồn và page khác nhau.&#x20;

* Nếu bạn muốn cấu hình các contact hiển thị từ Subiz về để có hiển thị nguồn là Subiz, vui lòng bỏ qua các bước ở giai đoạn 3 này.
* Nếu bạn muốn cấu hình các contact hiển thị từ Subiz về để có hiển thị nguồn cụ thể là khách hàng đến từ page nào thì làm theo các bước như sau:

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Truy cập trường tuỳ chỉnh "Nguồn" của khách hàng</mark>

Nhấn vào biểu tượng **Cài đặt -> Cấu hình hệ thống -> Trường tuỳ chỉnh** -> Tìm "**Nguồn**" trong danh sách các trường tuỳ chỉnh

<figure><img src="/files/hgIQUY5lxlbYL90hjH3Z" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Thêm mới</mark>

* Trên giao diện hệ thống CDP, nhấn vào **Thêm giá trị** để tạo nguồn mới cho contact đồng bộ về hệ thống.

<figure><img src="/files/BUfVjMHzXDoCONZNzJwA" alt=""><figcaption></figcaption></figure>

* Ở mỗi nguồn, bạn cần điền đầy đủ thông tin nhãn (tên nguồn) và giá trị (ID của page)
  * **Nhãn**: tên nguồn có thể được đặt tuỳ ý (Ví dụ: Fanpage Cocolux Official)
  * **Giá trị**: ID của mỗi nguồn được copy trên hệ thống Subiz.(Ví dụ: Nếu bạn muốn nhập thông tin nguồn từ Fanpage Facebook, truy cập vào danh mục **Cài đặt**, sau đó chọn **Facebook**, nếu bạn đã tích hợp page từ trước thì bạn có thể **copy mã** ở phía dưới tên Page như hình dưới đây, nếu bạn chưa tích hợp page nào thì nhấn vào **Tích hợp fanpage**. Bạn có thể làm tương tự đối với các nguồn khác như **Zalo, Instagram...**)

<figure><img src="/files/9hPHedGj5iwu0pqUcC6G" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Lưu cấu hình</mark>

Chọn **Lưu** hoặc **Lưu & Đóng** để lưu thao tác cấu hình nguồn contact.
{% endtab %}
{% endtabs %}

## <mark style="color:blue;">**4. Kiểm tra sự đồng bộ dữ liệu**</mark> <a href="#kiem-tra-dong-bo-subiz" id="kiem-tra-dong-bo-subiz"></a>

Sau khi đã hoàn thành các bước trên, bạn nên thao tác kiểm tra xem dữ liệu giữa 2 hệ thống đã đồng bộ chưa. Bạn có thể làm theo các bước sau:

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Nhập thông tin khách hàng trên Subiz</mark> <a href="#jvp5hgwc996g" id="jvp5hgwc996g"></a>

Trên hệ thống Subiz bạn thao tác nhập thông tin của 1 khách hàng như dưới đây:

<figure><img src="/files/gwjMVzOrpkqlGaeAK4jZ" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Chờ và check dữ liệu</mark>

Sau 5 phút, thông tin khách hàng sẽ được cập nhật trên module Quản lý khách hàng của hệ thống CDP.&#x20;

Tại CDP thao tác kiểm tra thông tin được đồng bộ về như sau:

<figure><img src="/files/h2nIsBqQbx88HB9Xh8K5" alt=""><figcaption></figcaption></figure>

Nếu dữ liệu được đồng bộ chính xác về hệ thống, điều đó có nghĩa là quá trình tích hợp của bạn đã thành công.&#x20;
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Trong quá trình kết nối, nếu bạn gặp vấn đề ở bất kỳ bước nào, vui lòng liên hệ với HUB để nhận được hỗ trợ thông qua các nhóm làm việc chung hoặc qua hotline 032.817.9699
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help-cdp.hub-js.com/data-collect/tich-hop-du-lieu/tich-hop-he-thong-chat-subiz.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.