이 페이지는 현재 영어로만 제공되며 한국어 버전은 곧 제공될 예정입니다. 기다려 주셔서 감사드립니다.

FAQS

Android

How do I troubleshoot if I cannot receive offline push messages?

Special Case Investigation

OPPO devices
There are several common reasons why OPPO devices do not receive push notifications:
According to the requirements of the official OPPO Push website, ChannelID must be configured on OPPO devices running Android 8.0 or above, otherwise, push notifications cannot be displayed. For the method of configuration, refer to setAndroidOPPOChannelID.
The notification bar display feature is disabled by default for applications installed on the OPPO device. If this is the case, check the switch status.
Google FCM
If push notifications are not received, verify whether the certificates have been correctly uploaded to the IM console. For the troubleshooting path, see the document Configuring in the IM console > Google FCM, and check against the diagram to see if it has been added correctly.
Xiaomi and vivo
Xiaomi and vivo: The app needs to be listed in the App Marketplace before it can be delivered through the Manufacturer Channel. It is usually indicated that the app is in the blocklist, prohibiting message sending. Or, the App has closed the push channel.
Sending messages as Custom Definition Messages
The offline push of Custom Definition Messages is different from ordinary messages. We cannot parse the content of Custom Definition Messages, and the push content cannot be determined. Therefore, by default, they are not pushed offline. If you have offline push requirements, you need to set the desc field of offlinePushInfo during sendMessage, and the desc information will be displayed by default during push.
Effects of Device Notification Bar Settings
The immediate effect of offline push is the Notification Bar Prompt, so like other notifications, it's affected by the device notification settings. Taking Huawei as an example:
Phone Settings > Notifications > Lock Screen Notifications > Hide or Do Not Display Notifications, will affect the display of offline push notifications when the screen is locked.
Phone Settings > Notifications > More Notification Settings > Status Bar Notification Icons, will affect the display of offline push notification icons in the status bar.
Phone Settings > Notifications > App Notification Management > Allow Notifications, toggling on or off will directly affect the display of offline push notifications.
Phone Settings > Notifications > App Notification Management > Notification Ringtone and Phone Settings > Notifications > App Notification Management > Silent Notifications, will affect the sound of offline push notification.
Message Type
Vendor push services all have message categorization mechanisms, and different types will have different push strategies. For details, please see Push Message Categorization.
Vendor Features
Offline push depends on the vendor's capabilities, and some simple characters may be filtered by the vendor and not be pushed through transparently. It is recommended to use meaningful content for pushing.

Self-service Push Troubleshooting Tool

Whether device push plugin integration is working properly
Test whether messages can be properly pushed offline by using the Offline Testing Tool in the IM Console.
Push Link Troubleshooting
Use the Troubleshooting Tool to view the details of the full push link.

How to troubleshoot if the jump interface is unsuccessful?

Click to perform a Configuration Check

See Custom Click-through Redirect for details, check:
Configure the subsequent actions after clicking in the console as follows, select Open the specified interface within the app, plugin users will by default fill in the jump parameters, check if the parameters have been modified.
Registration and callback processing for click events. It is recommended to register during the application Application's oncreate() function, which needs to be placed early in the application lifecycle.
Check if the click callback correctly handles the redirect logic.

Device System Permission Restrictions

If the application process does not exist and clicking the notification bar to jump to the application interface, it is necessary to pull the application from the background to the foreground. Some manufacturers' systems will check whether the App has enabled background self-start or floating window permissions. If not enabled, the system side will intercept and handle it, leading to failure.
Different manufacturers, and even different Android versions from the same manufacturer, offer different permissions and permission names for applications. Through testing, only the background pop-up interface permission needs to be enabled for Mi 6, while Redmi requires both the background pop-up interface and floating window display permissions, necessitating different treatments for different manufacturers.

Push Link Troubleshooting

Use the Troubleshooting Tool to view the details of the full push link.

Others

Huawei
Huawei Push Certificate ID <= 11344, using Huawei Push v2 Version Interface, does not support reach and click acknowledgment. If you need statistical data feature, please regenerate and update the Certificate ID.
AndroidInfo.ExtAsHuaweiIntentParam, passing "1" means treating the pass-through content Ext as an Intent parameter, "0" means treating the pass-through content Ext as an Action parameter. The restapi using "1" currently does not support click event statistics.
Statistical Data Feature
Only the push data details of the last device logged in are recorded; multi-platform login scenarios are not supported.
The Debug version of the App feature works normally, but anomalies occur with the Release version of the App feature
This issue is very likely caused by obfuscation. You can add the following obfuscation rules:
-keep class com.tencent.qcloud.** { *; }
-keep class com.tencent.timpush.** { *; }
Resolving conflicts between integrating TIMPush and other competitors
The reason is that the application itself or the third-party push client it integrates or depends on conflicts with the third-party client in TIMPush. It is necessary to keep only one in use. For specific methods, please refer to: TIMPush Integration Conflict Resolution.

iOS

Why doesn't offline push work for common messages?

First, check that the app runtime environment is the same as the certificate environment. Otherwise, offline push messages will not be received.
Next, check if the app and the certificate environment are set to production. If they are in a development environment, applying for a deviceToken from Apple might fail. This issue has not been found in the production environment, so please switch to production for testing.

Why doesn't offline push work for custom messages?

The offline push for custom messages differs from that for regular messages. We cannot parse the content of custom messages, making it impossible to determine the push content. Therefore, custom messages are not pushed by default. If you require push, you need to set the offlinePushInfo desc field during sendMessage. The desc information will by default be displayed during push.

How do I disable the receiving of offline push messages?

To disable receiving offline push messages, you can set the config parameter of the setAPNS API to nil. This feature has been supported starting from version 5.6.1200.

Push notifications are not received, and the server reports a 'bad devicetoken'.

Apple's deviceToken depends on the current build environment. If the certificate ID and token used when logging into IMSDK and uploading deviceToken to Tencent Cloud do not match, an error will occur.
If you are using the Release environment compilation, the - application:didRegisterForRemoteNotificationsWithDeviceToken: callback returns the production environment's token. At this time, set the `businessID` to the production environment's Certificate ID.
If you are using the Debug environment compilation, the - application:didRegisterForRemoteNotificationsWithDeviceToken: callback returns the development environment's token. At this time, set the `businessID` to the development environment's Certificate ID.
V2TIMAPNSConfig *confg = [[V2TIMAPNSConfig alloc] init];
/* You need to register a developer certificate with Apple, download and generate the certificate (P12 file) in their developer accounts, and upload the generated P12 file to the Tencent certificate console. The console will automatically generate a certificate ID and pass it to the `businessID` parameter.*/
// Push certificate ID
confg.businessID = sdkBusiId;
confg.token = self.deviceToken;
[[V2TIMManager sharedInstance] setAPNS:confg succ:^{
NSLog(@"%s, succ, %@", __func__, supportTPNS ? @"TPNS": @"APNS");
} fail:^(int code, NSString *msg) {
NSLog(@"%s, fail, %d, %@", __func__, code, msg);
}];

Under the iOS development environment, is the registration occasionally not returning a deviceToken or indicating a failure in requesting the token from APNs?

This problem is caused by instability of APNs. You can fix it in the following ways:
1. Insert a SIM card into the phone and use the 4G network.
2. Uninstall and reinstall the application, restart the application, or shut down and restart the phone.
3. Use a package for the production environment.
4. Use another iPhone.

iOS did not receive the delivery receipt

1. To report push delivery data, enable the console switch to support iOS 10's Extension feature. For more details, please refer to Statistics Push Arrival Rate.
2. To ensure reported data is not lost in abnormal conditions, iOS push data reporting will only occur upon the next log in, which may result in a delay. Please try to log in again.

iOS Certificate Expiration

In the IM console, click editing on the corresponding certificate and update the p12 certificate. It's important to note: do not delete the certificate and recreate it, as recreating the certificate will change the certificate ID, and an update will be required to support it.

iOS Statistical Reporting Feature

To report push reach data, this switch must be enabled to support iOS 10's Extension feature. For more details, please refer to Statistics Push Arrival Rate.

Others

Cannot Receive Push Notifications, Plugin Subscription Expired

Once the push plugin's trial or purchase expires, the push service will automatically stop (including standard message offline push, broadcast/Tag push, etc.). To avoid affecting the normal use of your business, please purchase/renew in advance.

Exchange and Feedback

Welcome to join the Tencent Cloud Chat Community for technical communication and feedback.