Create Google App

Khởi tạo dự án mới (Google Cloud Project)

• Truy cập vào trang quản trị Google Cloud Console.
• 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.

Kích hoạt các API cần thiết

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.

Khởi động cấu hình Google Auth Platform

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.

Cấu hình thông tin dự án (Project configuration)

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.

Khởi tạo mã xác thực (OAuth client ID)

Để 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):
  https://app.chatconnectx.com/integrations/google/callback
  
  • Sign-in Callback URL (Dùng cho tính năng Đăng nhập bằng Google):
  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.

Kích hoạt ứng dụng (Publish App) & Xác minh (Verification)

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.

Mở cấu hình kết nối

Đă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.

Nhập thông tin kết nối

Lưu cấu hình