# Problemas com figurinhas

> Resolva mídia indisponível, pedidos pendentes ao celular e problemas de acesso ao catálogo.

> **Note**
>
> Versão candidata. Estas operações de figurinhas ainda não estão disponíveis em homologação ou produção. Elas exigem a versão `2026-11-10` da API e os pacotes correspondentes publicados.

## A sincronização foi solicitada, mas o catálogo não mudou

`requested` confirma o envio do pedido. Mantenha o celular principal disponível
e aguarde o histórico ou os eventos `sticker.update`. Não apresente esse recibo
como sincronização concluída nem repita uma gravação automaticamente após um
tempo limite de transporte.

## A mídia da figurinha está indisponível

Os metadados não têm uma referência utilizável para envio. Com a permissão
necessária, solicite uma atualização da mídia e aguarde um resultado de sucesso
do celular. Uma falha ou um resultado desconhecido não restaura a mídia. Não use
uma URL sem relação ou o descritor de outra figurinha.

## A lista de recentes está vazia

As recentes pertencem à conta do número. Receber a figurinha de outra pessoa
não a adiciona. O estado hospedado também exige HMS habilitado, aceite dos termos
de armazenamento de figurinhas, acesso válido e dados retidos. Uma lista vazia
não prova que o celular não tenha pacotes instalados. Bancos do cliente precisam
da migração do esquema 3.

## Os termos estão indisponíveis ou uma alteração está incerta

Não considere termos indisponíveis como aceitos. Aguarde a publicação dos termos
revisados. Se o aceite ou a retirada não foi confirmado, atualize antes de tentar
novamente. A retirada fica nas configurações de Chats do escopo, mesmo sem
permissão de envio. As regras de retenção e exclusão continuam válidas.

## Remover uma recente não apagou um uso posterior

Envie o `lastStickerSentTs` observado em milissegundos. A remoção cobre esse uso
e os anteriores. Um uso posterior continua na lista. Não troque o valor pela
hora atual.

## Uma figurinha ou um pacote falha na validação

Verifique os limites da imagem e use uma única forma de origem. Pacotes enviados
como arquivo precisam de nomes sem diretórios, metadados correspondentes,
figurinhas válidas e os tipos de criptografia próprios do pacote. Autentique a
mídia baixada antes de ler seu conteúdo. Veja
[Figurinhas e pacotes](https://docs.polymorfa.com/pt-br/messaging/stickers).
