Bots do Telegram receberão um segundo nome de usuário, que poderá terminar não em "bot", mas em app, agent, ai, game ou gay. Um proprietário de bot com assinatura Telegram Premium poderá adicionar tal nome, um por bot. Com base no sufixo do nome, o cliente assina o bot na linha de status: em vez do familiar "bot", aparecerá "agent", "AI", "game" ou "app". Os métodos já estão presentes no TDLib, a assinatura no código do Telegram Desktop, e os textos de erro no Android 13.0.2, lançado em 13 de outubro. No arquivo de configuração do servidor em 9 de outubro, ainda não havia chaves para isso.
O que muda nas regras de nomenclatura
Atualmente, o username de um bot deve terminar em "bot": "tetris_bot" ou "TetrisBot", conforme exigido pela documentação do BotFather. Essa regra permanece: o nome principal do bot ainda termina em "bot".
A novidade é o segundo nome (na esquema do TDLib, ele é chamado de secondary_username). Ele não substitui o principal, mas coexiste com ele na lista de links do bot, como nomes adicionais de canais e contas. Há três restrições:
- o nome deve terminar em um dos sufixos permitidos, cuja lista é enviada pelo servidor;
- um bot pode ter apenas um nome desse tipo;
- um único proprietário não pode ter mais bots com esse tipo de nome do que o limite definido pelo servidor; por padrão, o TDLib define dois.
Se, ao criar um bot, você escolher um nome sem "bot" no final, o TDLib descreve o seguinte procedimento: o nome escolhido se tornará o segundo, e o servidor atribuirá automaticamente o nome principal, terminado em "bot", ao bot.
Como isso aparecerá para o proprietário do bot
Enquanto o servidor não enviar a lista de sufixos, não é possível adicionar um segundo nome em nenhum cliente. Quando for ativado, o processo pode ser lido pelas strings do cliente Android:
- no campo de nome, aparecerá uma dica: "deve terminar em 'bot' — ou em app, agent... com Telegram Premium";
- um nome com um novo sufixo sem assinatura resultará em uma mensagem informando que tais nomes exigem Premium, com um botão para assinatura;
- o terceiro bot com tal nome atingirá o limite: "você pode ter apenas N nomes desse tipo em todos os seus bots";
- uma segunda tentativa no mesmo bot será impedida por: "este bot já possui um nome Premium, remova-o antes de adicionar um novo".
A verificação de nome disponível é a mesma que para um novo bot, com um sinalizador separado "para segundo nome". O segundo nome pode ser removido a qualquer momento.
Onde a assinatura aparecerá
A assinatura é a string abaixo do nome do bot no cabeçalho do chat e no perfil, onde atualmente está escrito "bot". O Telegram Desktop a define com uma função curta: ela pega o primeiro nome na lista de links do bot e compara seu sufixo com cinco opções, ignorando maiúsculas e minúsculas. Se houver correspondência, a palavra da tabela é impressa em vez de "bot". Se não houver correspondência, "bot" permanece.
| Sufixo | Inglês | Russo (na plataforma de traduções) |
|---|---|---|
| app | app | приложение |
| agent | agent | агент |
| ai | ai | ИИ |
| game | game | игра |
| gay | gay | гей |
Um detalhe importante, que não é visível nos anúncios: se o servidor enviar o número de usuários ativos mensais para o bot, a linha de status o exibirá, e a assinatura baseada no sufixo não aparecerá. Ou seja, "agent" será visto principalmente em bots que não possuem esse contador.
Um segundo detalhe é que o primeiro nome na lista é verificado, seja qual for. O proprietário do bot pode alterar a ordem dos links arrastando-os, mas o esquema não especifica se é possível colocar o segundo nome no topo. Disso depende se a assinatura será vista em um bot cujo nome principal, terminado em "bot", está em primeiro lugar.
O quinto sufixo teve um caminho mais curto do que sua discussão. Nos códigos-fonte do Desktop, ele apareceu em 6 de outubro com o texto em inglês "non-binary", e em 8 de outubro na plataforma de traduções a opção em inglês foi substituída por "gay". A tradução russa lá mesmo, em dois dias, passou por «гей», «геи» e «gay», então a palavra final ainda pode mudar. Os outros quatro sufixos foram traduzidos sem divergências.
Isso é gratuito para Premium?
Mais precisamente, pode-se dizer que: o segundo nome está disponível apenas com Premium, e não há cobrança separada por ele no código. O método de adição no TDLib aceita dois argumentos — o bot e o nome, sem preço, estrelas ou Gram. O método de servidor bots.addUsername no esquema MTProto é estruturado da mesma forma. A lista de sufixos permitidos é chamada pelo TDLib de "Premium-sufixos", e pelo Android de "Premium-nome". Não há como comprar tal nome sem assinatura no código atual.
A mecânica não se cruza com o Fragment. O esquema chama explicitamente o segundo nome de "não colecionável" (non-collectible): não é um NFT-username de leilão, não é vendido nem transferido, mas sim ocupado, como um nome comum, se estiver disponível. Nomes colecionáveis do Fragment o bot já pode usar, e eles também podem não ter "bot" no final.
O que acontecerá quando a assinatura expirar, o esquema diz em uma única linha: se o segundo nome for desativado, ele só poderá ser reativado com Premium. Disso decorre a hipótese de que, com o vencimento do Premium, o nome é desativado, e não liberado — mas não há uma descrição direta desse cenário no código.
De onde o servidor obtém a lista de sufixos
Os cinco sufixos no Telegram Desktop são gravados diretamente no código: é um dicionário para a assinatura. Os sufixos permitidos para registro são lidos pelo TDLib da configuração do servidor do aplicativo, chave bot_allowed_suffixes, e entregues aos clientes pelo evento updateAllowedBotUsernamePremiumSuffixes (commit de 30 de setembro). O limite por proprietário vem com a chave bot_additional_usernames_limit. Na configuração de produção em 9 de outubro, nenhuma dessas chaves estava presente, portanto, a lista de sufixos no servidor pode ser mais curta ou mais longa do que os cinco conhecidos pelos clientes.
