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ấn đề về việc hiển thị băng chuyền và thẻ thông tin chi tiết
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:
- Mã nhân viên hỗ trợ
- Thông tin chi tiết về lỗi JavaScript xuất hiện trên Business Communications Developer Console
Không thể mở đường liên kết sâu 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ã 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