You can use the troubleshooting tool to troubleshoot message push exceptions such as message delivery or push failures and query device details (including the associated accounts and tags) via an account or token.
- A developer successfully pushes a message to the testing device via the console, but this message is not displayed in the notification bar of the device. Using a token to query the device details detects that the notification bar is disabled. Enable it on the device, trigger registration again, and send a message to the device again. The message is now displayed in the notification bar.
- An operator fails to push a message to a specified account. Using the account to query the token in the troubleshooting tool detects that the account hasn't been associated with a token yet. Please submit a ticket to check whether the API for Android or iOS was called to bind an account.
- After completing the TPNS integration, a developer pushes a message to a certain batch of device tokens, but an online user reports that the push message hasn't been reported. Querying the obtained token and
pushID of the user in the troubleshooting tool detects that the token is not in the push list.
Querying via account
- Log in to the TPNS Console.
- Select Toolbox -> Troubleshooting Tools on the left sidebar.
- Select the product and device from the drop-down list to be searched, and select Query by account for the Query Method.
- Enter the user account and click Query.
- Select the token associated with the account to view device details.
- Account: refers to the unique ID of the user bound to the token, including
- Token list: displays tokens in reverse chronological order by binding time. A maximum of 10 tokens are listed in a page. If the account is bound to multiple devices, the message will be pushed to the last device bound to this account. To push the message to all devices bound to this account, please change the push settings via the console or the API.
Querying via token
- Select Query through token for the Query Method on the Troubleshooting Tools page.
- Enter a token and click Query. You will see the device details on the right.
- Token: refers to the unique ID assigned to each device by TPNS. A token string cannot exceed 36 characters.
- If you want to obtain the device token, depending on your device type, please see the Android or iOS SDK documentation.
- Select Push Query on the Troubleshooting Tools page.
- Enter the
pushid (required) and the device token to be queried (required), and click Query to view the troubleshooting results.
pushid acquisition method:
- Select Push Management -> Task List on the left sidebar to obtain the
PushID to be queried.
- Obtain it from the response parameter of the push API.
- If the query result does not match the actual situation, or the problem persists, you can view the FAQs about push or submit a ticket with the
pushID and token for assistance.
- In what situations will the device token expire?
- The token is valid for 90 days. If the device hasn't been connected to the TPNS server for 90 consecutive days, the device will be considered as an unavailable device.
- If the application has been uninstalled from the device, the token will be considered as an invalid token.
- I have enabled the notification bar, but why is "notification bar status: disabled" displayed in the device details?
After the notification bar is enabled, please send the registration request from the client again to sync the notification bar status to the TPNS server.
- The account or tag push fails but the token push succeeds. Why does this happen?
A: On the Query device details page, verify that the token has been associated with the target account or tag to implement the account or tag push.
- The push message is in the completed status and the device is normal. Why can’t I receive the message on my mobile phone?