Google Chat Khoảng cách

  #Google Chat Tích hợp cho Botpress
Sự tích hợp này cho phép bạn kết nối Botpress chatbot với Google Chat không gian, cho phép giao tiếp liền mạch giữa bot của bạn và Google Chat người dùng. ## Tính năng - Gửi và nhận tin nhắn trong Google Chat spaces - Xử lý tin nhắn và phản hồi tự động - Hỗ trợ nhiều Google Chat spaces - Xác thực an toàn bằng Tài khoản dịch vụ Google ## Điều kiện tiên quyết 1. Tài khoản Google Cloud Platform (GCP) 2. Tài khoản Google Chat không gian nơi bạn muốn triển khai bot 3. Botpress ví dụ với Google Chat tích hợp đã cài đặt ## Hướng dẫn thiết lập ### 1. Bật Google Chat API 1. Truy cập [Google Cloud Console](https://console.cloud.google.com) 2. Điều hướng đến "API & Dịch vụ" > "Thư viện" 3. Tìm kiếm "Google Chat API" 4. Nhấp vào Google Chat API 5. Nhấp vào "Bật" để kích hoạt API cho dự án của bạn ### 2. Tạo Tài khoản dịch vụ Google 1. Truy cập [Google Cloud Console](https://console.cloud.google.com) 2. Tạo dự án mới hoặc chọn dự án hiện có 3. Điều hướng đến "IAM & Admin" > "Service Accounts" 4. Nhấp vào "Create Service Account" 5. Điền thông tin tài khoản dịch vụ và nhấp vào "Create" 6. Tạo khóa mới cho tài khoản dịch vụ: - Nhấp vào tài khoản dịch vụ - Truy cập tab "Keys" - Nhấp vào "Add Key" > "Create new key" - Chọn định dạng JSON - Tải xuống tệp khóa ### 3. Cấu hình Google Chat Cài đặt ứng dụng 1. Truy cập [Google Cloud Console](https://console.cloud.google.com) 2. Điều hướng đến "API & Dịch vụ" > "Google Chat API" 3. Nhấp vào "Cấu hình" 4. Thiết lập ứng dụng của bạn với các cài đặt sau: - **Tên ứng dụng**: Chọn tên cho bot của bạn - **Mô tả**: Thêm mô tả về chức năng của bot - **URL hình đại diện**: Thêm URL cho ảnh đại diện của bot - **Tính năng**: - Bật các tính năng tương tác - Bật nhận tin nhắn 1-1 - Bật tham gia không gian và trò chuyện nhóm - **URL điểm cuối HTTP**: Đặt thành Botpress webhook URL được tìm thấy trong Google Chat Cấu hình tích hợp. ### 4. Cấu hình tích hợp trong Botpress
1. Trong bạn Botpress Ví dụ, hãy đi đến phần Tích hợp 2. Tìm và chọn Google Chat tích hợp 3. Cấu hình các thiết lập sau: - **Service Account JSON**: Dán toàn bộ nội dung của tệp khóa tài khoản dịch vụ đã tải xuống của bạn - **Default Space**: Nhập ID của Google mặc định của bạn Chat khoảng trắng (tùy chọn) ### 5. Thêm Bot vào Google của bạn Chat Không gian 1. Mở Google của bạn Chat không gian 2. Nhấp vào tên không gian để mở thông tin chi tiết về không gian 3. Đi tới "Ứng dụng & tích hợp" 4. Nhấp vào "Thêm ứng dụng" 5. Tìm kiếm bot của bạn bằng email tài khoản dịch vụ 6. Thêm bot vào không gian của bạn ## Sử dụng ### Gửi tin nhắn Bot có thể gửi tin nhắn tới bất kỳ Google nào Chat không gian mà nó đã được thêm vào. Tin nhắn có thể được gửi: - Để trả lời tin nhắn của người dùng - Chủ động thông qua Botpress trình chỉnh sửa luồng - Thông qua các lệnh gọi API từ mã tùy chỉnh của bạn ### Nhận tin nhắn Bot tự động nhận và xử lý các tin nhắn được gửi trong Google Chat không gian. Nó sẽ: - Phân tích các tin nhắn đến - Xử lý chúng thông qua Botpress luồng - Gửi phản hồi phù hợp trở lại không gian ### Định dạng tin nhắn Tích hợp hỗ trợ tin nhắn văn bản trong Google Chat khoảng trắng. Tin nhắn có thể bao gồm: - Văn bản thuần túy - Định dạng cơ bản - Liên kết - Đề cập ## Cân nhắc về bảo mật - Giữ khóa tài khoản dịch vụ của bạn an toàn và không bao giờ chia sẻ công khai - Thường xuyên thay đổi khóa tài khoản dịch vụ của bạn - Sử dụng nguyên tắc đặc quyền tối thiểu khi chỉ định vai trò cho tài khoản dịch vụ của bạn - Theo dõi hoạt động của bot và thiết lập nhật ký phù hợp ## Khắc phục sự cố ### Các sự cố phổ biến 1. **Bot không phản hồi** - Xác minh tài khoản dịch vụ có đúng quyền - Kiểm tra xem bot đã được thêm đúng vào không gian chưa - Đảm bảo tích hợp được định cấu hình đúng trong Botpress
2. **Lỗi xác thực** - Xác minh JSON của tài khoản dịch vụ được định dạng đúng - Kiểm tra xem khóa tài khoản dịch vụ có hợp lệ và chưa hết hạn không - Đảm bảo tài khoản dịch vụ đã bật phạm vi API cần thiết 3. **Sự cố gửi tin nhắn** - Xác minh ID không gian là chính xác - Kiểm tra xem bot có được phép đăng trong không gian hay không - Đảm bảo định dạng tin nhắn hợp lệ ## Tham chiếu API Để biết thêm chi tiết về Google Chat API, hãy tham khảo [tài liệu chính thức](https://developers.google.com/chat/api/reference/rest).