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 RBM, bạn sẽ có một tài khoản đối tác. Để truy cập vào phần 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 (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	Nội dung mô tả
Tên đối tác	Tên tài khoản đối tác của bạn
Tên hiển thị	Tên sẽ xuất hiện trong báo cáo thanh toán RBM mà nhà mạng 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à đối tác đáng tin cậy và đảm bảo họ tạo thông tin lập hoá đơn chính xác để bạn tiếp cận người đăng ký sử dụng RBM. Tên bạn cung cấp ở đây phải phù hợp với tên dùng trong hợp đồng nhắn tin với 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ó bất kỳ vấn đề kỹ thuật nào 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 cấu hình đó. Khi bạn định cấu hình webhook đối tác, webhook này sẽ áp dụng cho tất cả nhân viên hỗ trợ của bạn. Nếu muốn sử dụng một webhook khác cho từng nhân viên hỗ trợ, bạn có thể thiết lập một webhook của nhân viên hỗ trợ. Thao tác này sẽ chỉ áp dụng cho nhân viên hỗ trợ đó.

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

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

Hãy 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 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 dữ liệu 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 của thương hiệu.
Nhấp vào nút rồi nhấp vào Edit name (Chỉnh sửa tên).
Thực hiện các thao tác chỉnh sửa và nhấp vào Xong.

Xoá thương hiệu

Bạn không thể xoá 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 ra mắt.

Để xoá một thương hiệu, hãy đánh dấu vào hộp bên cạnh tên của 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 trong tài khoản đối tác của mình. Người dùng đã tạo tài khoản đối tác có vai trò 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ể truy cập vào tất cả các chức năng của Developer Console để quản lý mọi nhân viên hỗ trợ thuộc tài khoản đối tác.
Độc giả có quyền chỉ có thể đọc đối với Developer Console để xem mọi nhân viên hỗ trợ 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 dữ liệu rồi chọn Vai trò của họ.

Khi bạn thêm 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.

Xóa 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 ở hàng trong bảng của họ.
Chọn Xoá người dùng.
Xác nhận xoá.

Người dùng bạn đã xoá sẽ nhận được email thông báo rằng họ không còn có 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 trong bảng của họ.
Chọn Chỉnh sửa vai trò.
Chọn vai trò mới từ 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 lệnh gọi API

Khi thực hiện lệnh gọi đến API RBM, bạn sẽ xác thực cuộc 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 với tư cách là nhân viên hỗ trợ.

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 an toàn và riêng tư. Đừng chia sẻ công khai khoá của bạn. Bạn sẽ cần khoá này sau để truy cập vào các API RBM.

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

Webhook là lệnh gọi lại HTTPS do đối tác tạo. Lệnh gọi lại này chỉ định cách nhân viên hỗ trợ của bạn sẽ 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.

Để đị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 dành cho đối tác RBM của bạn.
Mở phần Cài đặt tài khoản.
Đối với URL webhook 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://".
Hãy ghi lại giá trị clientToken của bạn. Bạn cần có mã này để xác minh rằng tin nhắn bạn nhận được là đến từ Google.
Hãy định cấu hình webhook của bạn để chấp nhận yêu cầu POST với thông số clientToken đã chỉ định và gửi phản hồi 200 OK có giá trị văn bản thuần tuý của thông số secret làm nội dung phản hồi.

Ví dụ: nếu webhook của bạn nhận được một yêu cầu POST có nội dung cơ thể sau đây
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}
```
thì webhook của bạn cần xác nhận giá trị clientToken và nếu clientToken chính xác, hãy trả về phản hồi 200 OK với 1234567890 là 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 RBM xác minh webhook của bạn, hộp thoại sẽ đóng lại.

Xác minh tin nhắn đến

Vì webhook có thể nhận tin nhắn từ bất kỳ người gửi nào, 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 thư cho bạn, hãy làm theo các bước sau:

Trích xuất tiêu đề X-Goog-Signature của thư. Đây là bản sao đã băm, được mã hoá base64 của tải trọng nội dung thư.
Base-64 giải mã 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 máy khách của webhook (mà bạn đã chỉ định khi thiết lập webhook) làm khoá, tạo HMAC SHA512 với các byte của tải trọng tin nhắn được giải mã base-64 và mã hoá base64 kết quả.
So sánh hàm băm X-Goog-Signature với hàm băm bạn đã tạo.
- Nếu hàm băm khớp với nhau, thì bạn xác nhận rằng Google đã gửi tin nhắn đó.
- Nếu hàm băm không khớp, hãy kiểm tra quá trình băm của bạn để xem một thông báo đã biết là tốt.
  
  Nếu quy trình băm của bạn đang hoạt động chính xác và bạn nhận được một thông báo cho rằng đã bị 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

Tài khoản đối tác của bạn hiện đã được thiết lập, đã đến lúc tạo nhân viên hỗ trợ đầu tiên.