O Telegram está preparando um botão "Delete Gift": um presente comum poderá ser excluído permanentemente, e não apenas ocultado do perfil. As strings para essa janela apareceram na plataforma de traduções do Telegram para iOS em 20 de outubro, e o método de exclusão na versão beta do Telegram para Android 13.1.0 de 19 de outubro. O servidor já aceita a solicitação: em uma conta de teste, dois presentes foram excluídos e não podem ser restaurados. O método ainda não está na documentação da API.
Como isso se parece
Na plataforma de traduções para iOS, quatro strings apareceram: o item "Delete Gift" no menu do presente, o título da janela com o mesmo texto, a notificação "Gift Deleted" e o próprio aviso: "Do you want to delete this gift? It will disappear from your profile and can't be restored". Em outras palavras, o presente desaparecerá do perfil e não poderá ser restaurado.
Na versão beta para Android, a mesma janela é montada a partir de suas próprias strings: título, texto de aviso e dois botões, "Delete" e "Cancel". Pressionar "Delete" envia uma única solicitação ao servidor com um único parâmetro — um link para o presente salvo.
Qual a diferença entre exclusão e ocultação
É possível ocultar um presente do perfil há muito tempo. Um presente oculto permanece na sua lista de presentes com a marcação "não mostrar", e pode ser retornado ao perfil a qualquer momento. Um presente excluído desaparece completamente da lista.
A diferença é visível nas respostas do servidor. O cliente recebe a lista de presentes da conta com a solicitação payments.getSavedStarGifts. Em 20 de outubro, em uma conta de teste, o mesmo presente foi primeiro ocultado e depois excluído:
| Ação | Presente na lista | Mensagem com o presente no chat privado |
|---|---|---|
| Ocultar do perfil | permanece, com a flag unsaved | permanece, a marcação «salvo» é removida |
| Excluir | desaparece | permanece, a marcação «salvo» é removida |
A mensagem pela qual o presente chegou permanece no chat após a exclusão. Não há uma flag separada "excluído": tanto ao ocultar quanto ao excluir, a mesma marcação é removida, e os dois casos só podem ser diferenciados pela presença do presente na lista. É possível excluir um presente que já estava oculto — na medição, um presente assim foi excluído.
Nem a ocultação nem a exclusão enviam qualquer notificação às sessões abertas da conta: a alteração é visível apenas ao reler a lista.
O que desaparece junto com o presente
Um presente comum pode ser trocado por Telegram Stars nos primeiros sete dias. O prazo é definido pelo parâmetro do servidor stargifts_convert_period_max, que atualmente é de 604.800 segundos. Na medição, um presente de 15 Stars, que ainda poderia ser trocado por 13 Stars, foi excluído. Após a exclusão, a oferta de troca desapareceu da mensagem, e nenhuma marcação de que a troca ocorreu apareceu.
Portanto, um presente com menos de uma semana, do qual você deseja se livrar, é mais vantajoso trocar: a troca também o remove do perfil, mas devolve as Stars. Faz sentido excluir o que não pode mais ser trocado. Apenas presentes colecionáveis (upgraded gifts) podem ser vendidos ou transferidos, e como fazer isso é explicado separadamente.
Onde isso já está disponível
| Onde | O quê | Data |
|---|---|---|
| Beta do Telegram para Android 13.1.0, build 7227 | método payments.deleteStarGift no esquema, layer 232 | 19 de outubro |
| Beta do Telegram para Android 13.1.0, build 7229 | no changelog: «não recarregar toda a lista de presentes ao excluir» | 19 de outubro |
| Plataforma de traduções, iOS | quatro strings da janela de exclusão | 20 de outubro |
| Telegram Desktop, branch dev | não, esquema no layer 231 | — |
| Documentação da API | apenas exclusão de coleção de presentes | — |
O método em core.telegram.org ainda responde "Page not found". O payments.deleteStarGiftCollection descrito lá é diferente: ele exclui uma coleção (pasta) na qual você agrupou presentes no perfil, mas os próprios presentes permanecem.
Na medição, apenas presentes comuns foram excluídos. Ainda não foi verificado se um presente colecionável pode ser excluído da mesma forma e se o remetente vê que seu presente foi excluído.
