Ao configurar um domínio personalizado como seu handle no Bluesky, a plataforma precisa verificar que você controla o domínio. Se a verificação falhar, o Bluesky exibe o erro “Handle Inválido” e reverte seu nome de exibição para o formato padrão username.bsky.social. Esse problema geralmente ocorre porque o registro DNS TXT necessário está ausente, incorreto ou ainda não foi propagado pela internet. Este artigo explica a causa exata da falha de verificação e fornece as etapas detalhadas para resolvê-la.
Principais Conclusões: Corrigir Handle Inválido para Domínio Personalizado no Bluesky
- Registro DNS TXT em
_atproto.<seudominio.com>: O Bluesky lê este registro para confirmar a propriedade do domínio; um registro ausente ou digitado incorretamente causa o erro Handle Inválido. - Atraso na propagação DNS: Alterações em registros TXT podem levar até 48 horas para se espalhar; verificar muito cedo mostra o erro.
- Configurações do Bluesky > Conta > Handle: O menu onde você insere o domínio personalizado e aciona a re-verificação após o DNS ser atualizado.
Por que o Bluesky Mostra Handle Inválido para um Domínio Personalizado
O Bluesky usa um protocolo descentralizado chamado AT Protocol. Quando você atribui um domínio personalizado como seu handle, o Bluesky não armazena seu domínio. Em vez disso, ele lê um registro DNS TXT que você deve publicar em um subdomínio específico: _atproto.seudominio.com. Este registro contém uma string que prova que você controla o domínio.
Se o registro TXT estiver ausente, contiver um erro de digitação ou apontar para o valor errado, o Bluesky não consegue verificar a propriedade. O sistema então marca o handle como inválido e reverte para o handle padrão username.bsky.social. Atrasos na propagação DNS também causam um estado temporário de Handle Inválido mesmo quando o registro está correto.
Como é o Registro DNS do AT Protocol
O formato exato do registro TXT necessário é:
Host: _atproto.seudominio.com Valor TXT: did=did:plc:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
O prefixo did= e a string DID completa devem corresponder exatamente ao que o Bluesky fornece nas configurações da sua conta. Um sinal de dois pontos ausente, espaço extra ou string DID errada causarão o erro Handle Inválido.
Passos para Corrigir o Erro Handle Inválido
Siga estes passos em ordem. Não pule a verificação de propagação DNS.
- Faça login no seu provedor DNS
Abra o painel de controle do registrador de domínios ou serviço de hospedagem DNS onde seu domínio é gerenciado. Provedores comuns incluem Cloudflare, GoDaddy, Namecheap, Google Domains e AWS Route 53. - Localize a seção de gerenciamento DNS
Encontre a área chamada Registros DNS, Arquivo de Zona ou DNS Avançado. O nome exato varia conforme o provedor. - Exclua qualquer registro TXT
_atprotoexistente
Se você tentou esta configuração anteriormente, remova qualquer registro TXT antigo para o host_atproto. Registros obsoletos com valores errados impedem a verificação. - Adicione um novo registro TXT
Crie um novo registro com estes valores exatos:- Tipo: TXT
- Host/Nome:
_atproto(ou_atproto.seudominio.comdependendo do provedor) - Valor:
did=did:plc:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx— substitua o placeholder pelo seu DID real - TTL: 300 (5 minutos) ou o menor valor permitido para propagação mais rápida
- Copie seu DID do Bluesky nas configurações da conta
Vá em Configurações do Bluesky > Conta > Handle. Clique em “Eu tenho meu próprio domínio.” A página exibe sua string DID. Copie exatamente, incluindo o prefixodid:plc:. - Aguarde a propagação DNS
As alterações DNS não são instantâneas. Aguarde pelo menos 15 minutos, mas a propagação pode levar até 48 horas. Para verificar se o registro está visível globalmente, use uma ferramenta de consulta DNS gratuita como whatsmydns.net ou dig em um terminal:dig TXT _atproto.seudominio.com. - Volte ao Bluesky e acione a re-verificação
Em Configurações do Bluesky > Conta > Handle, insira seu domínio personalizado completo (por exemplo,seudominio.com). Clique em “Salvar” ou “Atualizar.” O Bluesky tentará imediatamente ler o registro TXT. Se o registro estiver visível, seu handle será atualizado em segundos. - Confirme a alteração do handle
Sua página de perfil agora mostra o domínio personalizado como seu handle. A mensagem de erro desaparece. Se não desaparecer, prossiga para a próxima seção.
Se o Bluesky Ainda Mostrar Handle Inválido Após a Correção Principal
O registro DNS está presente, mas o Bluesky ainda mostra Handle Inválido
Isso geralmente significa que o valor TXT está incorreto. Abra o registro DNS e compare toda a string de valor com o DID mostrado nas Configurações do Bluesky. Erros comuns incluem:
- Falta do prefixo
did= - Digitar
did:duas vezes (por exemplo,did=did:did:plc:...) - Incluir um espaço no final ou caractere de nova linha
- Usar um DID diferente de uma conta antiga
Corrija o registro, salve, aguarde 15 minutos e acione a re-verificação novamente nas Configurações do Bluesky.
A propagação não alcançou os servidores do Bluesky
Mesmo que uma ferramenta de consulta DNS mostre o registro como visível a partir da sua localização, o Bluesky pode consultar um resolvedor DNS diferente que ainda não foi atualizado. Aguarde de 2 a 4 horas e tente novamente. Se o erro persistir após 48 horas, o registro está quase certamente errado.
Você usou um subdomínio em vez do domínio raiz
O Bluesky suporta domínios personalizados em qualquer nível: seudominio.com, blog.seudominio.com ou usuario.seudominio.com. No entanto, o registro TXT deve ser colocado exatamente no subdomínio que você pretende usar. Se você deseja o handle blog.seudominio.com, o host do registro TXT deve ser _atproto.blog.seudominio.com. Uma incompatibilidade entre o host do registro e o handle que você insere nas Configurações do Bluesky causa o erro Handle Inválido.
Seu provedor DNS usa CNAME flattening ou proxy
Alguns provedores como Cloudflare oferecem um proxy (nuvem laranja) que pode interferir na resolução de registros TXT. Para o registro _atproto, desative qualquer proxy ou aceleração CDN. Configure o registro como Somente DNS (nuvem cinza no Cloudflare).
Domínio Personalizado do Bluesky vs Handle Padrão: Principais Diferenças
| Item | Handle com Domínio Personalizado | Handle Padrão bsky.social |
|---|---|---|
| Formato | seudominio.com ou subdomínio | username.bsky.social |
| Prova de propriedade | Registro DNS TXT no subdomínio _atproto | Nenhuma (Bluesky possui o domínio) |
| Estado de falha de verificação | Reverte para handle padrão | Nenhuma falha possível |
| Portabilidade | Você pode mover sua identidade para outro serviço AT Protocol | Vinculado ao Bluesky |
| Tempo de configuração | 5 minutos mais propagação DNS | Instantâneo |
A tabela acima mostra que um domínio personalizado oferece portabilidade de identidade, mas requer gerenciamento cuidadoso de DNS. O handle padrão é mais simples, mas prende sua identidade ao Bluesky.
Agora você sabe por que o erro Handle Inválido aparece e como corrigi-lo com o registro DNS TXT correto. Após a verificação, seu handle de domínio personalizado permanece ativo enquanto o registro DNS estiver publicado. Para evitar problemas futuros, defina um TTL longo de 86400 segundos (24 horas) após a verificação inicial ser bem-sucedida. Isso reduz a chance de exclusão acidental do registro durante alterações de DNS.