Hướng dẫn khắc phục sự cố về RBM

Hãy làm theo hướng dẫn này để cung cấp thông tin cần thiết nhằm khắc phục sự cố liên quan đến RBM.

Không thể gửi tin nhắn RBM

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

  • Mã thông báo tin nhắn mẫu có dấu thời gian
  • Mã đối tác (xem ảnh chụp màn hình)
  • Số lượng nhân viên hỗ trợ chịu ảnh hưởng
  • Mã nhân viên hỗ trợ (phân tách bằng dấu phẩy)
  • Số lượng thư ước tính bị ảnh hưởng hoặc có thể bị ảnh hưởng
  • Các phương thức API mà bạn đang gặp vấn đề (ví dụ: tải tệp lên, tạo tác nhân cho tin nhắn của người dùng, tạo tác nhân cho sự kiện của người dùng, xoá tác nhân cho tin nhắn của người dùng, nhận chức năng, nhận hàng loạt)
  • Gói dữ liệu JSON mẫu của các yêu cầu không thành công
  • Đối với vấn đề về ứng dụng: Báo cáo lỗi ứng dụng
  • Nhật ký lỗi (lỗi xuất hiện trong thiết bị đầu cuối khi gọi API RBM), bao gồm mã lỗi và thông báo lỗi. Ví dụ:

    "error": {
    "code": 403,
    "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
    "status": "PERMISSION_DENIED",
    }
    

Độ trễ trong việc thực hiện các hành động RBM

Trước tiên, hãy nhớ kiểm tra những điều sau:

Câu hỏi Nội dung đề xuất
Độ trễ có phải là <5s không? Nếu có, thì mức chênh lệch này nằm trong phạm vi chấp nhận được.
Độ trễ có hồi quy không? Nếu có thì vấn đề này bắt đầu từ khi nào? Độ trễ thông thường trước đây so với hiện tại là bao nhiêu?
Bạn có đang sử dụng API tải tệp lên không? Hãy thử sử dụng mã tệp thay vì gửi URL trực tiếp. Quá trình xử lý URL nội dung nghe nhìn mới bao gồm việc tải xuống, xử lý, hình thu nhỏ, bảo vệ chống hành vi sai trái và bảo vệ chống vi-rút – trong đó, quá trình bảo vệ chống vi-rút chiếm khoảng 50% thời gian.
Bạn đã tải nội dung nghe nhìn của thư lên trước chưa? Để tăng tốc quá trình xử lý, bạn nên thực hiện việc này bằng lệnh gọi API sau: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Bạn đã chạy quy trình kiểm tra chức năng chưa? Để giảm độ trễ khi gửi tin nhắn cho những người dùng không thể liên lạc được qua RCS, trước tiên, hãy chạy quy trình kiểm tra chức năng.

Nếu vấn đề vẫn tiếp diễn, vui lòng cung cấp nhiều thông tin chi tiết nhất có thể để khắc phục sự cố nhanh hơn:

  • Số lượng thư bị ảnh hưởng
  • Nguồn độ trễ (ví dụ: tải tệp lên, tạo tin nhắn của nhân viên hỗ trợ cho người dùng, tạo sự kiện của nhân viên hỗ trợ cho người dùng, xoá tin nhắn của nhân viên hỗ trợ cho người dùng, nhận chức năng, nhận hàng loạt)
  • Điểm cuối dịch vụ
  • Phân phối độ trễ (p50, p95, p99)
  • Thay đổi về độ trễ và khung thời gian
  • Mã nhận dạng đối tác
  • Mã nhân viên hỗ trợ bị ảnh hưởng
  • Mã nhận dạng thư có dấu thời gian
  • Gói dữ liệu JSON

Không nhận được sự kiện hoặc thông báo tại webhook

Để đảm bảo việc gửi tin nhắn diễn ra suôn sẻ, hãy xác minh rằng tất cả webhook của nhân viên hỗ trợ trong tài khoản đối tác của bạn đều hoạt động đúng cách và có thể xử lý tin nhắn từ Google. Tất cả nhân viên hỗ trợ trong một tài khoản đối tác đều dùng chung một kênh cho các tin nhắn và sự kiện đến. Vì vậy, một webhook không hoạt động có thể làm gián đoạn việc phân phối cho tất cả nhân viên hỗ trợ.

Nếu vấn đề vẫn tiếp diễn, hãy chia sẻ những thông tin chi tiết sau để chúng tôi có thể khắc phục sự cố nhanh hơn:

  • Vấn đề bắt đầu từ khi nào? Trước đó, bạn có nhận được thông báo và sự kiện thành công không?
  • Mã nhận dạng đối tác
  • Mã nhân viên hỗ trợ
  • URL webhook
  • Mã nhận dạng thư có dấu thời gian

Ví dụ về vấn đề này bao gồm không tải được, hiển thị màn hình đen, cắt và các thao tác được đề xuất không xuất hiện.

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

  • Mã nhận dạng thư có dấu thời gian
  • Gói dữ liệu JSON
  • Các bước tái hiện vấn đề trên thiết bị (nếu có)
  • Báo cáo lỗi từ thiết bị nhận tin nhắn
  • Thông tin chi tiết về thiết bị và phiên bản ứng dụng nhắn tin được sử dụng
  • Ảnh chụp màn hình hoặc bản ghi video về vấn đề

Tin nhắn RBM được gửi dưới dạng JSON hoặc chuyển đổi thành SMS

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

  • Mã nhận dạng thư có dấu thời gian
  • Gói dữ liệu JSON
  • Các bước tái hiện vấn đề trên thiết bị (nếu có)
  • Báo cáo lỗi từ thiết bị nhận tin nhắn
  • Thông tin chi tiết về thiết bị và phiên bản ứng dụng nhắn tin được sử dụng
  • Ảnh chụp màn hình hoặc bản ghi video về vấn đề

Không tạo được URL P2A hoặc mã QR

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

  • Mã nhân viên hỗ trợ
  • Số điện thoại
  • Các bước để tái hiện vấn đề (nếu có)
  • Báo cáo lỗi (từ thiết bị đã mở đường liên kết)
  • Ảnh chụp màn hình hoặc bản ghi video về vấn đề

Không nhận được tin nhắn trên thiết bị có hỗ trợ RCS

Hãy chia sẻ càng nhiều thông tin chi tiết sau đây càng tốt để có thể khắc phục sự cố nhanh hơn:

  • Báo cáo lỗi từ thiết bị không nhận được thông báo RBM
  • Số điện thoại
  • Thông tin chi tiết về thiết bị và hệ điều hành
  • Phiên bản ứng dụng nhắn tin được sử dụng
  • Các bước để tái hiện vấn đề (nếu có)
  • Ảnh chụp màn hình cho thấy trạng thái RCS
  • Ảnh chụp màn hình hoặc bản ghi video về vấn đề
  • Tên và quốc gia của nhà mạng

Không thể thêm người kiểm thử

Làm theo các bước trong phần Thiết lập thiết bị thử nghiệm.

Nếu vấn đề vẫn tiếp diễn, hãy chia sẻ những thông tin chi tiết sau để chúng tôi có thể khắc phục sự cố nhanh hơn:

  • Mã nhân viên hỗ trợ
  • Số điện thoại
  • Tên và quốc gia của nhà mạng

Thiết bị kiểm thử không nhận được lời mời hoặc tin nhắn của người kiểm thử

Làm theo các bước trong phần Thiết lập thiết bị thử nghiệm.

Nếu vấn đề vẫn tiếp diễn, hãy chia sẻ những thông tin chi tiết sau để chúng tôi có thể khắc phục sự cố nhanh hơn:

  • Mã nhân viên hỗ trợ
  • Số điện thoại
  • Mã thông báo có dấu thời gian
  • Báo cáo lỗi trong vòng 5 phút kể từ khi gửi lời mời thử nghiệm

Vấn đề về việc kiểm tra chức năng

Hãy chia sẻ những thông tin chi tiết sau đây để chúng tôi có thể khắc phục sự cố nhanh hơn:

  • Danh sách số điện thoại có mã quốc gia được đưa vào tệp CSV
  • Mã nhân viên hỗ trợ
  • Nhật ký lỗi
  • Trạng thái RCS của thiết bị

Thiếu thông tin trong báo cáo sự kiện thanh toán

Hãy chia sẻ những thông tin chi tiết sau đây để chúng tôi có thể khắc phục sự cố nhanh hơn:

  • Ngày mà tệp bị thiếu
  • Mã nhân viên hỗ trợ

Nhà mạng không thể phê duyệt việc khởi chạy tác nhân

Báo cáo vấn đề trong Bảng điều khiển quản trị RBM (xem ảnh chụp màn hình).

Đối với các bản phát hành khẩn cấp, vui lòng cung cấp:

  • Tên và quốc gia của nhà mạng
  • Mã nhân viên hỗ trợ sẽ được khởi chạy
  • Uỷ quyền của nhà mạng để ra mắt

Yêu cầu cập nhật thông tin chi tiết về nhân viên hỗ trợ

Hãy chia sẻ các thông tin chi tiết sau để bật tính năng cập nhật nhanh hơn:

  • Mã nhân viên hỗ trợ
  • Thông tin chi tiết về siêu dữ liệu cần cập nhật (ví dụ: tên, biểu trưng, biểu ngữ, nội dung mô tả, thông tin liên hệ, đường liên kết đến chính sách quyền riêng tư hoặc đường liên kết đến điều khoản dịch vụ)

Yêu cầu di chuyển nhân viên hỗ trợ sang một tài khoản đối tác khác

Hãy chia sẻ các thông tin chi tiết sau để bật tính năng cập nhật nhanh hơn:

  • Danh sách mã nhân viên hỗ trợ
  • Mã đối tác cũ
  • Mã đối tác mới