Khắc phục sự cố thiết lập thông báo đẩy

Bài viết này đề cập đến các vấn đề có thể xảy ra với thiết lập thông báo đẩy trong Customer Insights - Hành trình và cung cấp một số giải pháp khắc phục sự cố.

Sự cố đăng ký thiết bị

Sau đây là các sự cố đăng ký thiết bị có thể xảy ra.

Tôi đang gọi API công khai đăng ký thiết bị, nó trả về '202', nhưng không có gì xảy ra

API công khai đăng ký thiết bị trả về theo cách không đồng bộ, đó là lý do tại sao mã trạng thái phản hồi là 202 (Đã chấp nhận) chứ không phải 200 (OK). Yêu cầu bắt đầu quá trình đăng ký, nhưng điều này không nhất thiết có nghĩa là thao tác đã thành công. Có một API trạng thái đăng ký thiết bị riêng biệt mà bạn cần gọi để xem kết quả đăng ký. Sử dụng tùy chọn được RegistrationRequestId cung cấp để phản hồi quá trình thực thi API đăng ký thiết bị để yêu cầu trạng thái đăng ký.

API trạng thái đăng ký hiển thị thông báo lỗi sau: Mã thông báo API được cung cấp không hợp lệ

Nội dung yêu cầu API đăng ký thiết bị có trường ApiToken và giá trị của nó phải bằng giá trị trong trường hiển thị trong phần "Mã truy cập" của tab "Thông tin nhà phát triển" trong cấu hình ứng dụng di động trong giao diện người dùng CRM. Đảm bảo giá trị được sử dụng trong API được lấy từ đúng ứng dụng di động và đúng mã ứng dụng di động được sử dụng cho yêu cầu.

API trạng thái đăng ký bao gồm văn bản lỗi sau: Gửi thông báo kiểm tra vô hình không thành công cho mã thông báo thiết bị nhất định

Là một phần của quy trình đăng ký thiết bị, Customer Insights gửi thông báo đẩy thử nghiệm vô hình cho mã thông báo thiết bị nhất định. Nếu gửi không thành công, quá trình đăng ký cũng không thành công. Các phần dưới đây giải thích sự cố, phù hợp với loại nền tảng (Android hoặc iOS).

Sự cố gửi thông báo đẩy cho Android

Sau đây là sự cố gửi thông báo đẩy cho thiết bị Android.

Gửi lỗi bao gồm thông báo "JSON tài khoản dịch vụ được cung cấp không chính xác"

Để gửi thông báo đẩy, Customer Insights cần tải lên tệp JSON tài khoản dịch vụ chính xác trong giao diện người dùng CRM ứng dụng dành cho thiết bị di động. Một sai lầm phổ biến là sử dụng một tệp google-service.json . Tệp này được sử dụng trong mã nguồn của chính ứng dụng dành cho thiết bị di động và không nên được sử dụng trong CRM. Để xem cách tìm nạp tệp JSON tài khoản dịch vụ chính xác, hãy xem Chuyển đổi thông báo đẩy Android sang mã thông báo Nhắn tin đám mây Firebase (FCM) để xác thực .

Gửi lỗi bao gồm mã lỗi "PROJECT_NOT_PERMITTED"

Có khả năng dịch vụ "Firebase In-App Messaging API" chưa được bật. Điều hướng đến "Google Cloud" từ bên trong giao diện người dùng Bảng điều khiển Firebase, tìm "API nhắn tin In-App Firebase" và bật nó.

Customer Insights tuyên bố thông báo đã được gửi thành công, nhưng không có thông báo nào xuất hiện trên màn hình

Customer Insights gửi thông báo đẩy bằng định dạng tải trọng dữ liệu. Điều này là bắt buộc để thực hiện các thay đổi trong mã ứng dụng di động để nhận tải trọng thông báo đẩy và hiển thị nó dưới dạng cửa sổ bật lên. Để biết thêm hướng dẫn, hãy xem Nhận thông báo đẩy trên thiết bị di động.

Để biết thêm thông tin về các định dạng tải trọng dữ liệu trong Firebase, hãy xem các loại tin nhắn FCM.

Gửi lỗi bao gồm mã lỗi hoặc thông báo không rõ ràng

Customer Insights gửi thông báo đẩy trực tiếp bằng máy chủ Firebase. Phản hồi lỗi đến trực tiếp từ máy chủ Firebase nếu có lỗi gửi. Xem lại tài liệu tham khảo ErrorCode để biết tất cả các mã lỗi có thể xảy ra và ý nghĩa của chúng.

Sự cố gửi thông báo đẩy cho iOS

Đối với sự cố gửi thông báo cho iOS, bạn có thể sử dụng các trang web bên ngoài của bên thứ ba để giúp khắc phục sự cố, chẳng hạn như https://apnspush.com/>'. Các trang web này cho phép bạn nhanh chóng kiểm tra việc gửi thông báo đẩy và xem liệu có bất kỳ thay đổi nào hoạt động hay không.

Gửi lỗi bao gồm mã lỗi BadDeviceToken

Lý do phổ biến nhất cho lỗi này là môi trường không khớp của mã thông báo thiết bị và cấu hình CRM. Khi mã thông báo thiết bị được tạo bởi một ứng dụng iOS, nó cũng được tạo cho chế độ Hộp cát hoặc Sản xuất. Đảm bảo đặt cùng một chế độ ứng dụng trong giao diện người dùng CRM và sử dụng cùng một thông tin đăng nhập chế độ ứng dụng trong ứng dụng CRM dành cho thiết bị di động.

Gửi không thành công đối với mã thông báo thiết bị iOS được bao bọc bởi Firebase

Customer Insights hiện không hỗ trợ mã thông báo thiết bị iOS hoạt động bằng FCM. Đảm bảo rằng mã thông báo thiết bị được sử dụng để đăng ký thiết bị iOS có mã thông báo thiết bị APNS gốc ở định dạng chính xác. Mã thông báo này chỉ bao gồm các ký hiệu HEX, ví dụ: 0123456789ABCDEF. Đảm bảo mã thông báo không vượt quá 64 ký tự.

Gửi lỗi bao gồm mã lỗi hoặc thông báo không rõ ràng

Customer Insights gửi thông báo đẩy trực tiếp bằng máy chủ APNS. Phản hồi lỗi đến trực tiếp từ máy chủ APNS nếu có lỗi gửi. Review hướng dẫn lập trình thông báo cục bộ và từ xa: Giao tiếp với APN để biết tất cả các mã lỗi có thể xảy ra và ý nghĩa của chúng.