Studio

Domínios personalizados

Com um domínio personalizado, sua página de destino, suas páginas legais, seu kit de imprensa, seus códigos QR e seus deep links são servidos a partir de um domínio seu, como get.habitly.app, com HTTPS configurado para você. Os domínios personalizados fazem parte do plano Studio, que inclui até 25 domínios por espaço de trabalho. Proprietários e admins do espaço de trabalho podem adicioná-los.

O que um domínio personalizado exibe

Cada domínio é conectado a um app:

URL	Exibe
`https://get.habitly.app/`	Página de destino
`/go/{store}`	Redirecionamento rastreado para uma loja, como `/go/google_play`
`/open/{path}`	Deep links
`/privacy`, `/terms`	Política de privacidade e termos, com `/{language}` opcional
`/press`, `/press.zip`	Kit de imprensa
`/qr.svg`, `/qr.png`	Código QR
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	Arquivos de associação para Universal Links e Android App Links

A raiz mostra a página de destino para todos. Diferentemente de mapps.one/habitly, ela não redireciona celulares para uma loja. Use o link inteligente quando quiser detecção de dispositivo, ou get.habitly.app/go/app_store quando quiser uma loja específica. As URLs do link inteligente e do código QR exibidas no painel e na API continuam usando mapps.one.

Antes de começar

Use um subdomínio, como get., download. ou app.. O padrão do DNS não permite registros CNAME em um domínio raiz como habitly.app.
Você precisa ter acesso às configurações de DNS do domínio, no seu registrador ou provedor de DNS.
Um domínio só pode ser conectado uma vez em todo o mapps.one.

1. Adicione o domínio

No painel, abra Domínios, escolha Adicionar domínio, digite get.habitly.app e escolha o app que ele deve servir. Em seguida, o painel mostra os registros DNS que você deve criar, incluindo um token de verificação exclusivo do seu domínio.

2. Crie os registros DNS

Tipo	Nome	Valor	Finalidade
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	Comprova que você controla o domínio
CNAME	`get.habitly.app`	`domains.mapps.one`	Envia o tráfego para o mapps.one

Se o seu provedor de DNS não conseguir criar um registro CNAME para esse nome, crie em vez disso um registro A apontando para o endereço IP exibido no painel.

Muitos provedores de DNS adicionam o domínio raiz automaticamente. Nesse caso, digite apenas a parte que vem antes dele: _mapps-verify.get para o registro TXT e get para o registro CNAME.

Usa Cloudflare? Defina o registro CNAME como DNS only (nuvem cinza). Se o registro estiver com proxy, o certificado não pode ser emitido e os visitantes veem um erro.

3. Verifique

Escolha Verificar agora ao lado do domínio. Nós verificamos o registro TXT e para onde o domínio aponta. Domínios pendentes também são verificados automaticamente a cada 10 minutos, então você pode fechar a página e voltar mais tarde. As alterações de DNS costumam aparecer em poucos minutos, mas alguns provedores levam algumas horas.

Status	Significado
Pendente	Aguardando os registros DNS aparecerem
Verificado	O domínio está servindo o seu app
Falha	Um registro está faltando ou incorreto. O painel mostra o motivo. Corrija o registro e verifique novamente.

Um webhook domain.verified é enviado quando a verificação é concluída.

HTTPS

Um certificado TLS é emitido automaticamente na primeira vez que alguém abre o domínio por HTTPS depois que ele é verificado. Essa primeira solicitação pode levar alguns segundos, e as seguintes são rápidas. Não há nada para enviar nem renovar.

Solução de problemas

Confira o que o resto do mundo vê com dig ou com qualquer ferramenta on-line de consulta de DNS:

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

O nome está duplicado, como em get.habitly.app.habitly.app: seu provedor acrescentou o domínio raiz. Digite apenas get.
Existe outro registro para o mesmo nome, como um registro A antigo. Remova-o, porque um CNAME não pode compartilhar o nome com outros registros.
Proxy ou CDN na frente: mude o registro para DNS only.
Registros CAA no seu domínio que só permitem uma autoridade certificadora específica podem bloquear o certificado. Remova-os ou amplie-os.

Remova um domínio

Exclua o domínio no painel e depois remova os registros DNS no seu provedor. Se o espaço de trabalho sair do plano Studio, os domínios personalizados dele deixam de servir páginas até você fazer upgrade novamente. Os links no mapps.one continuam funcionando.