Bản cập nhật: Kiểm tra ghi chú phát hành để biết thông tin về các tính năng mới và bản cập nhật sản phẩm.

Trang này được dịch bởi Cloud Translation API.

Thiết lập tài khoản đối tác

Sau khi đăng ký làm đối tác RCS cho Doanh nghiệp, bạn sẽ có một tài khoản đối tác. Để truy cập vào chế độ cài đặt tài khoản đối tác, hãy mở Business Communications Developer Console rồi nhấp vào Partner account settings (Chế độ cài đặt tài khoản đối tác). Tại đây, bạn có thể làm những việc sau:

Cập nhật thông tin tài khoản đối tác

Trên trang Cài đặt, bạn có thể xem mã đối tác và cập nhật những thông tin sau:

Trường	Mô tả
Tên đối tác	Tên tài khoản đối tác
Tên hiển thị	Tên sẽ xuất hiện trong báo cáo thanh toán mà hãng vận chuyển nhận được (dưới dạng trường `owner_name`). Các nhà mạng sẽ sử dụng thông tin này để xác định bạn là một đối tác đáng tin cậy và tạo thông tin lập hoá đơn chính xác cho việc bạn sử dụng RCS cho doanh nghiệp để tiếp cận người đăng ký của họ. Tên mà bạn cung cấp ở đây phải khớp với tên được dùng trong hợp đồng nhắn tin của nhà mạng.
Đầu mối liên hệ về vấn đề kỹ thuật	Người mà Google sẽ liên hệ nếu có vấn đề kỹ thuật với nhân viên hỗ trợ của bạn. Bạn có thể cập nhật Tên Địa chỉ email của công ty Số điện thoại
Webhook	Đây là URL điểm cuối webhook của bạn. Nhấp vào Định cấu hình để cập nhật. Khi bạn định cấu hình webhook đối tác, chế độ này sẽ áp dụng cho tất cả các tác nhân của bạn. Nếu muốn sử dụng một webhook khác cho từng tác nhân, bạn có thể thiết lập một webhook tác nhân chỉ áp dụng cho tác nhân đó.

Quản lý thương hiệu

Là đối tác RCS for Business, bạn có thể tạo nhân viên hỗ trợ thay mặt cho các thương hiệu.

Sử dụng trang Thương hiệu trong phần Cài đặt tài khoản để thêm, chỉnh sửa và xoá các thương hiệu được liên kết với tài khoản đối tác của bạn.

Thêm thương hiệu

Để thêm một thương hiệu, hãy nhập tên của thương hiệu đó vào trường nhập rồi nhấp vào Thêm.

Chỉnh sửa thương hiệu

Cách chỉnh sửa thương hiệu:

Nhấp vào hộp đánh dấu bên cạnh tên thương hiệu.
Nhấp vào nút rồi nhấp vào Chỉnh sửa tên.
Chỉnh sửa rồi nhấp vào Xong.

Xoá thương hiệu

Bạn không thể xoá một thương hiệu nếu thương hiệu đó được liên kết với một nhân viên hỗ trợ, ngay cả khi nhân viên hỗ trợ đó chưa được khởi chạy.

Để xoá một thương hiệu, hãy nhấp vào hộp đánh dấu bên cạnh tên thương hiệu rồi nhấp vào Xoá.

Quản lý người dùng

Trang Người dùng trong phần Cài đặt tài khoản là nơi bạn quản lý người dùng của tài khoản đối tác. Người dùng đã tạo tài khoản đối tác có vai trò là Chủ sở hữu. Người dùng mới có thể có vai trò là Người quản lý hoặc Người đọc.

Người quản lý có thể sử dụng tất cả các chức năng của Developer Console để quản lý mọi tác nhân thuộc tài khoản đối tác.
Người đọc chỉ có quyền đọc đối với Play Console, để xem mọi tác nhân thuộc tài khoản đối tác.

Thêm người dùng

Để thêm người dùng, hãy nhập địa chỉ email của họ vào trường nhập liệu rồi chọn Vai trò của họ.

Khi bạn thêm một người dùng mới, họ sẽ nhận được email thông báo rằng họ có quyền truy cập vào tài khoản đối tác.

Xoá người dùng

Cách xoá người dùng:

Tìm người dùng mà bạn muốn xoá, rồi nhấp vào nút trong hàng tương ứng của họ trong bảng.
Chọn Xoá người dùng.
Xác nhận xoá.

Người dùng mà bạn xoá sẽ nhận được email thông báo rằng họ không còn quyền truy cập vào tài khoản đối tác nữa.

Bạn không thể xoá người dùng có vai trò Chủ sở hữu. Để thay đổi hoặc xoá Chủ sở hữu, bạn cần liên hệ với nhóm hỗ trợ.

Thay đổi vai trò của một người dùng

Cách cập nhật vai trò của người dùng:

Tìm người dùng mà bạn muốn cập nhật rồi nhấp vào nút trong hàng tương ứng của họ trong bảng.
Chọn Chỉnh sửa vai trò.
Chọn một vai trò mới trong trình đơn thả xuống.
Nhấp vào Lưu.

Thiết lập tài khoản dịch vụ để xác thực các lệnh gọi API

Khi thực hiện các lệnh gọi đến RBM API, bạn sẽ xác thực các lệnh gọi bằng khoá tài khoản dịch vụ. Khoá này cho phép bạn tạo và quản lý các thương hiệu và nhân viên hỗ trợ, cũng như gửi tin nhắn và yêu cầu dưới vai trò là nhân viên hỗ trợ. Một tài khoản dịch vụ có thể có tối đa 10 khoá.

Để xác thực các lệnh gọi API một cách an toàn, bạn cũng cần có công cụ dòng lệnh oauth2l.

Hãy làm theo các bước sau để tạo khoá tài khoản dịch vụ:

Trong phần Cài đặt tài khoản, hãy chuyển đến trang Tài khoản dịch vụ.
Nhấp vào Tạo khoá, rồi nhấp vào Tạo. Trình duyệt của bạn sẽ tải khoá tài khoản dịch vụ xuống.

Lưu trữ khoá tài khoản dịch vụ của bạn ở một nơi riêng tư và bảo mật. Đừng chia sẻ khoá của bạn công khai. Sau này, bạn sẽ cần khoá này để truy cập vào các API RBM.

Định cấu hình webhook đối tác

Webhook là một lệnh gọi lại HTTPS do đối tác tạo, chỉ định cách nhân viên hỗ trợ của bạn phản hồi các tin nhắn và sự kiện. Sau khi định cấu hình webhook, bạn có thể bắt đầu nhận tin nhắn và sự kiện.

Nếu muốn sử dụng một webhook khác cho bất kỳ nhân viên hỗ trợ nào, bạn có thể thiết lập một webhook ở cấp độ nhân viên hỗ trợ để ghi đè webhook của đối tác. Để biết thêm thông tin, hãy xem phần Định cấu hình webhook của tác nhân.

Để định cấu hình webhook của đối tác, hãy làm theo các bước sau:

Mở Business Communications Developer Console rồi đăng nhập bằng Tài khoản Google của đối tác RCS for Business.
Mở phần Cài đặt tài khoản.
Đối với URL webhook RCS Business Messaging, hãy nhấp vào Định cấu hình.
Đối với URL điểm cuối webhook, hãy nhập URL webhook bắt đầu bằng "https://".
Ghi lại giá trị clientToken. Bạn cần khoá này để xác minh rằng thư bạn nhận được là của Google.
Định cấu hình webhook để chấp nhận yêu cầu POST có tham số clientToken được chỉ định và gửi phản hồi 200 OK có giá trị văn bản thuần tuý của tham số secret làm nội dung phản hồi.

Ví dụ: nếu webhook của bạn nhận được yêu cầu POST có nội dung sau đây
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}
```
thì webhook của bạn phải xác nhận giá trị clientToken và nếu clientToken là chính xác, hãy trả về một phản hồi 200 OK với 1234567890 làm nội dung phản hồi:
```
// clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});
```
Trong Developer Console, hãy nhấp vào Xác minh. Khi RCS for Business xác minh webhook của bạn, hộp thoại sẽ đóng.

Để biết hướng dẫn về cách xử lý webhook không đồng bộ nhằm ngăn chặn lỗi gửi, hãy xem phần Xử lý thông báo.

Xác minh tin nhắn đến

Vì webhook có thể nhận tin nhắn từ mọi người gửi, nên bạn phải xác minh rằng Google đã gửi tin nhắn đến trước khi xử lý nội dung tin nhắn.

Để xác minh rằng Google đã gửi một thông báo mà bạn nhận được, hãy làm theo các bước sau:

Trích xuất phần đầu trang X-Goog-Signature của thư. Đây là bản sao được băm và mã hoá base64 của tải trọng nội dung thư.
Giải mã Base64 tải trọng RBM trong phần tử message.body của yêu cầu.
Sử dụng mã thông báo ứng dụng khách của webhook (bạn đã chỉ định khi thiết lập webhook) làm khoá, hãy tạo một HMAC SHA512 gồm các byte của tải trọng thông báo được giải mã base-64 và mã hoá kết quả bằng base64.
So sánh hàm băm X-Goog-Signature với hàm băm mà bạn đã tạo.
- Nếu các hàm băm khớp nhau, tức là bạn đã xác nhận rằng Google gửi tin nhắn.
- Nếu các hàm băm không khớp, hãy kiểm tra quy trình băm của bạn trên một thông báo đã biết là tốt.
  
  Nếu quy trình băm của bạn hoạt động bình thường và bạn nhận được một thông báo mà bạn cho rằng được gửi cho bạn một cách gian lận, hãy liên hệ với chúng tôi.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

Các bước tiếp theo

Bây giờ, khi tài khoản đối tác của bạn đã được thiết lập, đã đến lúc bạn tạo tác nhân đầu tiên.

Đăng ký làm đối tác

Tiếp

Tạo nhân viên hỗ trợ đầu tiên của bạn