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

Sau khi đăng ký làm đối tác RCS for Business, 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ở RCS for Business Developer Console (Bảng điều khiển dành cho nhà phát triển RCS for Business) 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
• 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 của bạn
• Quản lý người dùng tài khoản
• Tạo tài khoản dịch vụ và khoá để xác thực các lệnh gọi API

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 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 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 của 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.

Thương hiệu Một tổ chức hoặc nhóm được đại diện bởi một hoặc nhiều tác nhân. Ví dụ: công ty dịch vụ tài chính Growing Tree có thể tạo một thương hiệu tên là Growing Tree và một đặc vụ tên là Growing Tree Bank để nói chuyện với khách hàng về các dịch vụ ngân hàng.

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

Lưu ý: Để thêm một thương hiệu bằng RBM Management API, hãy tham khảo tài liệu Tạo 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

Lưu ý: Để chỉnh sửa một thương hiệu bằng RBM Management API, hãy tham khảo tài liệu Đổi tên thương hiệu.

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

1. Nhấp vào hộp đánh dấu bên cạnh tên thương hiệu.
2. Nhấp vào nút rồi nhấp vào Chỉnh sửa tên.
3. 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 ra mắt.

Để 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:

1. Tìm người dùng mà bạn muốn xoá rồi nhấp vào nút trong hàng của họ trong bảng.
2. Chọn Xoá người dùng.
3. 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:

1. 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.
2. Chọn Chỉnh sửa vai trò.
3. Chọn một vai trò mới trong trình đơn thả xuống.
4. 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 gọi 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ụ:

1. Trong phần Cài đặt tài khoản, hãy chuyển đến trang Tài khoản dịch vụ.
2. 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 vị trí 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

Để tìm hiểu cách thiết lập webhook của đối tác, hãy xem hướng dẫn về Webhook.

Để 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:

1. Trích xuất tiêu đề X-Goog-Signature của thư. Đây là bản sao đã băm và được mã hoá base64 của tải trọng nội dung thư.
2. Giải mã Base64 cho tải trọng RBM trong phần tử message.body của yêu cầu.
3. 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 HMAC SHA512 cho 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.
4. 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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  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.