Sticker troubleshooting
Resolve unavailable sticker media, pending phone requests and catalog access problems.
The phone sync was requested, but the catalog did not change#
requested confirms that Polymorfa issued the request. Keep the primary phone available and wait for history or sticker.update events. Do not present the request receipt as completed synchronization or automatically issue another write after a transport timeout.
A sticker shows Media unavailable#
Its display metadata does not include a usable send reference. If you have the required permission, request a media refresh and wait for a successful phone result. A failed or unknown result does not restore media. Do not substitute an unrelated URL or another sticker's descriptor.
Recent stickers are empty#
Recents belong to the Number's own account. Receiving someone else's sticker does not add it. Hosted state also needs enabled HMS, accepted sticker-storage terms, live access and retained data. An empty catalog does not prove that the phone has no installed packs. Customer-owned stores need the schema 3 migration.
The storage terms are unavailable or a change is unconfirmed#
Do not treat unavailable terms as accepted. Wait until the reviewed terms are available. If acceptance or withdrawal could not be confirmed, refresh before trying again. Withdrawal remains available from the scope's Chats settings without send permission. Existing retention and deletion rules still apply.
Removing a recent did not remove a newer use#
Supply the exact observed lastStickerSentTs in milliseconds. Removal covers that use and older uses. A later use remains recent; do not replace the timestamp with the current time.
A sticker or pack fails validation#
Check the image limits and use one source form. For an uploaded pack, use flat file names, matching item metadata, valid sticker bytes and the pack encryption domains. Authenticate downloaded media before parsing it. See Stickers and sticker packs.