> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Google App
> Learn how to create a custom Google App to obtain Client ID and Client Secret under your own brand.
Tạo Google App riêng giúp tùy biến màn hình cấp quyền của Google hiển thị tên thương hiệu và logo của riêng bạn khi khách hàng kết nối tài khoản hoặc sử dụng tính năng đồng bộ dữ liệu.
Cấu hình Google App sẽ được áp dụng chung cho ba tính năng cốt lõi trên portal của bạn:
* Đăng nhập bằng tài khoản Google (Google Login).
* Đồng bộ dữ liệu bảng tính (Google Sheets)
## Các bước cấu hình trên Google Cloud Console
Bạn thực hiện đăng ký ứng dụng theo quy trình dưới đây:
* Truy cập vào trang quản trị [Google Cloud Console](https://console.cloud.google.com).
* Nhấp vào danh sách dự án ở góc trên bên trái màn hình và chọn **New Project**.
* Đặt tên dự án tương ứng với thương hiệu portal của bạn và nhấn **Create** để khởi tạo.
Truy cập vào mục **APIs & Services > Library** thông qua thanh tìm kiếm hoặc menu điều hướng, tìm kiếm và kích hoạt thư viện sau:
* **Google Sheets API**: Dùng để đọc và ghi dữ liệu lên bảng tính của khách hàng.
Chọn mục **Google Auth Platform** ở menu điều hướng bên trái. Tại giao diện **OAuth Overview**, nhấn nút **Get started**.
Trình cấu hình **Project configuration** xuất hiện, thực hiện điền thông tin qua 4 bước:
* **App Information**: Nhập tên thương hiệu của bạn tại ô **App name** và chọn **User support email** từ danh sách thả xuống. Nhấn **Next**.
* **Audience**: Cấu hình đối tượng người dùng. Tích chọn **External** để hỗ trợ khách hàng sử dụng tài khoản Google cá nhân bên ngoài tổ chức của bạn. Nhấn **Next**.
* **Contact Information**: Tại ô **Email addresses**, nhập địa chỉ email liên hệ của bạn để nhận các thông báo thay đổi dự án từ Google. Nhấn **Next**.
* **Finish**: Tích chọn vào ô đồng ý với điều khoản **I agree to the Google API Services: User Data Policy**, sau đó nhấn **Continue** rồi nhấn nút **Create** để lưu cấu hình.
Hệ thống sẽ hiển thị thông báo **OAuth configuration created!** ở cuối màn hình và tự động chuyển hướng bạn quay lại trang tổng quan.
Để lấy mã **Client ID** và **Client Secret**, bạn di chuyển sang tab **Clients** ở menu bên trái:
* Nhấp chọn **+ Create client** ở phía trên.
* Chọn Application type là **Web application**.
* Tại ô **Name**, đặt tên gợi nhớ cho ứng dụng (ví dụ: `Web client 1`).
* Tại mục **Authorized JavaScript origins**, nhấn **+ Add URI** và nhập đường dẫn tên miền portal gốc của bạn (ví dụ: `https://app.yourdomain.com`).
* Tại mục **Authorized redirect URIs**, nhấn **+ Add URI** hai lần để thêm đầy đủ cả 2 đường dẫn chuyển hướng callback được hệ thống ChatbotX cung cấp:
* **Auth Callback URL** (Dùng cho Google Sheets):
```http theme={null}
https://app.chatconnectx.com/integrations/google/callback
```
* **Sign-in Callback URL** (Dùng cho tính năng Đăng nhập bằng Google):
```http theme={null}
https://app.chatconnectx.com/api/auth/callback/google
```
* Nhấn **Create** ở cuối trang. Hệ thống sẽ hiển thị hộp thoại bật lên **OAuth client created** chứa mã **Client ID** và **Client Secret** của bạn.
**Lưu ý quan trọng:** Hãy sao chép ngay mã **Client ID** và **Client Secret** ở bước này và lưu trữ an toàn. Google sẽ không hiển thị lại mã **Client Secret** sau khi bạn đóng hộp thoại này.
Chọn mục **Audience** ở menu bên trái:
* Nhấp chọn **Publish App** để chuyển ứng dụng từ trạng thái thử nghiệm (Testing) sang hoạt động chính thức (In Production). Thao tác này giúp mọi người dùng ngoài danh sách test có thể sử dụng tính năng đăng nhập Google của bạn.
* Khi ứng dụng chuyển sang hoạt động chính thức, Google sẽ yêu cầu bạn thực hiện các bước xác minh tại **Verification Center** (Trung tâm xác minh) ở menu bên trái:
* **Xác minh thông tin thương hiệu (Branding status)**: Google sẽ kiểm tra logo, tên ứng dụng và các liên kết pháp lý (Privacy Policy, Terms of Service) của bạn. Bạn cần bấm **View branding** và hoàn tất các thông tin theo yêu cầu của Google. Nếu không xác minh thương hiệu, khi khách đăng nhập sẽ hiển thị màn hình cảnh báo bảo mật của Google (ví dụ: *"Google hasn't verified this app"*).
* **Xác minh quyền truy cập dữ liệu (Data access status)**: Kiểm tra trạng thái cấp quyền truy cập dữ liệu nhạy cảm (sensitive scopes) hoặc hạn chế (restricted scopes). Nếu ứng dụng của bạn không yêu cầu quyền nhạy cảm (như Sheets hay Calendar ở mức restricted), trạng thái sẽ hiển thị *"Verification is not required"* (Không yêu cầu xác minh dữ liệu) và bạn có thể sử dụng bình thường mà không cần làm gì thêm ở mục này.
## Thiết lập Verify Token và đồng bộ vào Portal
Để hoàn tất kết nối ứng dụng Google vào portal quản trị, bạn cần chuẩn bị thêm mã xác thực Webhook:
### Webhook Verify Token là gì?
**Webhook Verify Token** là một chuỗi ký tự bảo mật do chính bạn tự tạo ra (chọn một chuỗi ký tự ngẫu nhiên gồm chữ và số có độ dài từ 16 đến 32 ký tự).
Chuỗi ký tự này được sử dụng làm khóa bảo mật để hệ thống xác thực các yêu cầu gửi về từ Google Calendar API. Khi có cập nhật lịch trình, Google sẽ gửi thông báo kèm theo token này trong tiêu đề yêu cầu HTTP (`X-Goog-Channel-Token`), giúp hệ thống đối chiếu và xác nhận yêu cầu thực sự đến từ Google chứ không phải một bên thứ ba giả mạo.
### Nhập cấu hình vào Portal quản trị
Đăng nhập vào Portal quản trị của bạn, truy cập mục **SaaS > Platform Credentials**, chọn cổng kết nối Google và nhấn **Edit**.
Điền đầy đủ ba thông số đã chuẩn bị vào biểu mẫu:
* **Client ID**: Dán mã Client ID nhận được từ Google Cloud.
* **Client Secret**: Dán mã Client Secret nhận được từ Google Cloud.
* **Webhook Verify Token**: Nhập chuỗi ký tự bảo mật do bạn tự tạo ở bước trước.
Nhấn **Save** để lưu lại và hoàn tất kích hoạt ứng dụng Google dùng chung cho toàn bộ khách hàng trên portal.