{
"title": "Como alterar seu subdomínio Zendesk: Um guia completo para 2026",
"slug": "zendesk-subdomain-change",
"locale": "pt",
"date": "2026-03-02",
"updated": "2026-03-02",
"template": "default",
"excerpt": "Alterar seu subdomínio Zendesk afeta toda a sua operação de suporte. Este guia cobre quando fazer isso, como se preparar e o que quebra (para que você possa consertar).",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"subdomain",
"host mapping",
"customer support",
"help center"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Como alterar seu subdomínio Zendesk: Um guia completo para 2026",
"description": "Alterar seu subdomínio Zendesk afeta toda a sua operação de suporte. Este guia cobre quando fazer isso, como se preparar e o que quebra (para que você possa consertar).",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-14ae5d74-99dc-4e18-b79d-47eedcae4d0e"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-14ae5d74-99dc-4e18-b79d-47eedcae4d0e",
"coverImageAlt": "Imagem do banner para Como alterar seu subdomínio Zendesk: Um guia completo para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Perguntas Frequentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "Quanto tempo leva para concluir uma alteração de subdomínio Zendesk?",
"answer": "A renomeação real entra em vigor imediatamente e leva apenas alguns segundos para ser executada. No entanto, o processo completo, incluindo a preparação e as tarefas pós-alteração, normalmente leva várias horas para ser concluído, com algumas alterações relacionadas ao DNS potencialmente levando até 24 horas para serem totalmente propagadas."
},
{
"question": "Posso alterar meu subdomínio Zendesk de volta se cometer um erro?",
"answer": "Sim, você pode alterar seu subdomínio novamente, se necessário. No entanto, seu antigo subdomínio fica disponível para outras contas Zendesk reivindicarem imediatamente após você alterá-lo. Não há garantia de que você poderá recuperá-lo se outra pessoa o pegar."
},
{
"question": "A alteração do meu subdomínio Zendesk afetará o conteúdo da minha central de ajuda?",
"answer": "Não, todos os seus artigos da central de ajuda, tickets, contas de usuário e configurações permanecem intactos. Apenas o URL muda. No entanto, links codificados para seu antigo subdomínio em artigos ou modelos precisarão ser atualizados."
},
{
"question": "Preciso atualizar meu certificado SSL após uma alteração de subdomínio Zendesk?",
"answer": "Se você usar o certificado Let's Encrypt gratuito do Zendesk, ele será regenerado automaticamente. Se você usar um certificado SSL personalizado para host mapping, precisará gerar um novo certificado que cubra seu novo subdomínio."
},
{
"question": "O que acontece com minhas integrações Zendesk quando eu altero meu subdomínio?",
"answer": "A maioria das integrações será interrompida e precisará ser reconfigurada. Jira e Salesforce exigem desativação e reativação. As integrações baseadas em API precisam de atualizações de URL do endpoint. As configurações de SSO devem ser atualizadas com o novo subdomínio. As integrações do Sunshine Conversations devem ser excluídas e recriadas inteiramente."
},
{
"question": "O host mapping é uma alternativa melhor para alterar meu subdomínio Zendesk?",
"answer": "Para a maioria das alterações de branding, sim. O host mapping permite que você mostre aos clientes um domínio personalizado (como support.suaempresa.com) sem alterar seu subdomínio Zendesk real. Isso evita a quebra de integrações, a alteração de endereços de e-mail ou a necessidade de uma limpeza pós-alteração extensa. É a abordagem que o Zendesk recomenda para alterações de URL voltadas para o cliente."
}
],
"supportLink": null
}
}
---
Quando sua empresa muda de nome, se funde com outra ou passa por um rebranding, seu subdomínio Zendesk também pode precisar ser alterado. É uma decisão significativa. Ao contrário da atualização do seu logotipo ou assinatura de e-mail, alterar seu subdomínio Zendesk afeta todos os URLs, integrações e conexões de API em sua operação de suporte.
Este guia orienta você através de tudo o que você precisa saber: quando fazer a alteração, como se preparar, o que quebra (e como você vai consertar) e se você realmente precisa de uma alteração de subdomínio. Também veremos como nossa [integração de IA do Zendesk](https://www.eesel.ai/integration/zendesk-ai) funciona perfeitamente com qualquer configuração de subdomínio que você escolher.
## O que é um subdomínio Zendesk e por que alterá-lo?
Seu subdomínio Zendesk é o identificador exclusivo no URL do seu help desk. Se seu endereço for `suaempresa.zendesk.com`, então "suaempresa" é seu subdomínio. É assim que o Zendesk encaminha o tráfego para sua conta específica e como os clientes encontram sua central de ajuda. Saiba mais na [documentação oficial do Zendesk sobre subdomínios](https://support.zendesk.com/hc/en-us/articles/4408845973914).
Aqui estão os motivos mais comuns pelos quais as equipes alteram seu subdomínio:
- **Rebranding da empresa** Sua empresa mudou de nome e o antigo subdomínio não reflete mais sua marca
- **Fusão ou aquisição** Duas empresas se combinaram e precisam de uma presença de suporte unificada
- **Spin-off** Uma divisão se tornou sua própria entidade e precisa de branding separado
- **Requisitos legais** Conflitos de marca registrada ou outros problemas legais com o nome atual
Aqui está o ponto crítico a ser compreendido: renomear seu subdomínio entra em vigor imediatamente. Seu antigo URL para de funcionar no momento em que você confirma a alteração. O Zendesk não pode configurar redirecionamentos em seu nome. Qualquer pessoa com favoritos, modelos de e-mail ou documentação contendo seu antigo URL chegará a um beco sem saída.
É por isso que a preparação é tão importante. A renomeação real leva segundos. O trabalho está em tudo o que vem antes e depois.
## Alteração de subdomínio vs host mapping: Qual você precisa?
Antes de prosseguir, certifique-se de que você realmente precisa de uma renomeação de subdomínio. Muitas equipes confundem isso com host mapping, e escolher a abordagem errada cria trabalho desnecessário.
**Renomeação de subdomínio** altera seu endereço Zendesk real. Se você estiver em `antigaempresa.zendesk.com` e renomear para `novaempresa`, seu novo endereço se torna `novaempresa.zendesk.com`. Esta é uma alteração interna que afetará toda a sua instância Zendesk.
**Host mapping** mantém seu subdomínio Zendesk original, mas mostra aos clientes um domínio personalizado. Sua central de ajuda aparece em `support.suaempresa.com`, enquanto seus agentes ainda usam `suaempresa.zendesk.com` internamente. Isso afeta apenas o que os clientes veem, não como sua conta funciona.
Veja como decidir:
| Cenário | Abordagem Recomendada |
| :----------------------------------------------------------- | :-------------------- |
| Empresa renomeada, precisa que todos os URLs reflitam a nova marca | Renomeação de subdomínio |
| Deseja um URL de central de ajuda com aparência profissional | Host mapping |
| Fusão exigindo presença de suporte unificada | Renomeação de subdomínio |
| Rebranding de materiais voltados para o cliente apenas | Host mapping |
| Precisa preservar todas as integrações e conexões de API | Host mapping |
O Zendesk recomenda fortemente o [host mapping](https://support.zendesk.com/hc/en-us/articles/4408838571930) como a primeira alternativa a ser considerada. Ele oferece o branding profissional sem quebrar integrações, alterar endereços de e-mail ou exigir uma limpeza pós-alteração extensa.
Se o host mapping parece que pode resolver seu problema, nosso [guia completo para host mapping de marca Zendesk](https://www.eesel.ai/blog/zendesk-brand-host-mapping) explica todo o processo de configuração.
## Pré-requisitos e considerações importantes
Uma renomeação de subdomínio afeta quase todos os aspectos da sua configuração Zendesk, por isso vale a pena entender o que você está contratando. Você vai querer saber exatamente o que quebra e como você vai consertar.
### Requisitos
- Você deve ser o **proprietário da conta**. Os administradores não podem renomear subdomínios.
- Você não pode renomear subdomínios de contas sandbox.
- Seu novo subdomínio deve ter de 3 a 63 caracteres, contendo apenas letras de A a Z, números de 0 a 9 e traços. Sem sublinhados ou caracteres especiais.
### O que quebra e precisa ser consertado
**Os endereços de e-mail mudam imediatamente.** Se você usar `support@antigaempresa.zendesk.com`, ele se torna `support@novaempresa.zendesk.com`. As regras de encaminhamento externas devem ser atualizadas.
**O chat fica inacessível por até 2 horas.** Você vai querer planejar essa alteração durante períodos de baixo volume.
**Os endpoints da API mudam.** Quaisquer sistemas externos que usem sua API Zendesk precisarão atualizar seus URLs de `antigaempresa.zendesk.com/api/v2/...` para `novaempresa.zendesk.com/api/v2/...`.
**As integrações precisam de reconexão:**
- Jira: Desative antes da alteração, depois reative após
- Salesforce: Desconecte antes, depois reconecte após
- Sunshine Conversations: Você precisará excluir e recriar isso inteiramente
- Authenticated SMTP Connector: Descontinue antes, depois adicione novamente após
**O SSO quebra até que você o reconfigure.** As configurações [SAML e JWT](https://support.zendesk.com/hc/en-us/articles/4408845973914) referenciam seu subdomínio no URL do Access Consumer.
**Os acordos de compartilhamento de tickets devem ser recriados.** Quaisquer acordos de compartilhamento ativos com outras contas Zendesk precisarão ser desativados e configurados novamente.
**Limitações históricas de tickets.** Você não pode copiar e colar comentários ou imagens de tickets criados antes da renomeação. Anexos em tickets antigos não podem ser recuperados por meio de copiar/colar.
**Programas de acesso antecipado (EAPs)** vinculados ao seu subdomínio serão perdidos. Você precisará se candidatar novamente com seu novo subdomínio.
## Guia passo a passo para renomear seu subdomínio
Se você ponderou as considerações e decidiu prosseguir, aqui está exatamente o que você fará.
### Passo 1: Preparação pré-alteração
Comece documentando sua configuração atual. Você precisará desta referência durante a fase de limpeza. Aqui está o que capturar:
- Liste todas as regras de encaminhamento de e-mail externas apontando para seu subdomínio atual
- Identifique todas as integrações em Central de administração > Aplicativos > Aplicativos de canal
- Documente os endpoints da API usados por sistemas externos
- Anote quaisquer configurações de SSO (SAML ou JWT)
- Registre os acordos de compartilhamento de tickets ativos
- Verifique se você tem algum acesso EAP vinculado ao seu subdomínio
Agora você vai preparar as alterações:
1. Atualize as regras de encaminhamento de e-mail em seu registrador de domínio para apontar para seu novo endereço de subdomínio
2. Desative a integração do Jira em Central de administração > Aplicativos > Aplicativos de canal
3. Desconecte a integração do Salesforce se estiver conectada
4. Notifique sua equipe sobre a janela de tempo de inatividade planejada
5. Agende a alteração durante suas horas de menor volume de suporte
### Passo 2: Renomear o subdomínio
Esta é a alteração real. Leva segundos, mas tem efeito imediato. Aqui está o que você vai fazer:
1. Vá para [Central de administração](https://support.zendesk.com/hc/en-us/articles/4581766374554) > Conta > Aparência > Branding
2. Na seção Subdomínio, clique no menu Marcas
3. Clique no menu de opções ao lado de sua marca e selecione Editar
4. Insira seu novo nome de subdomínio
5. Clique em Salvar
6. Revise o aviso sobre as consequências e clique em Sim, alterar subdomínio
A alteração é imediata. Seu antigo URL não funcionará mais.
### Passo 3: Tarefas pós-alteração
Agora o trabalho de limpeza começa. Você vai trabalhar nesta lista de verificação:
**Integrações:**
- Reative a integração do Jira
- Reconecte o Salesforce
- Atualize o código do Web Widget em seu site (obtenha o novo código em Central de administração > Canais > Clássico > Web Widget)
- Atualize a configuração do Mobile SDK com o novo subdomínio
- Reconfigure o SSO com o novo URL do Access Consumer
**Sistemas externos:**
- Atualize os endpoints da API em todos os sistemas externos
- Atualize os tokens da API, se necessário
- Atualize os URLs do webhook
**Específico do Zendesk:**
- Recrie os acordos de compartilhamento de tickets
- Atualize o subdomínio de gerenciamento da força de trabalho (WFM), se aplicável
- Atualize as assinaturas de notificação de status
**Comunicação:**
- Notifique os clientes sobre os novos endereços de e-mail de suporte
- Atualize os modelos de e-mail e assinaturas
- Revise os artigos da central de ajuda que mencionam o antigo URL
- Atualize quaisquer materiais de marketing ou documentação
## Problemas comuns e solução de problemas
Mesmo com uma preparação cuidadosa, as coisas podem dar errado. Aqui está o que você vai querer observar:
**Erros de certificado SSL.** Se você usar host mapping com SSL, precisará atualizar ou regenerar seu certificado para o novo subdomínio.
**Atrasos no encaminhamento de e-mail.** A propagação do DNS pode levar horas. Se os e-mails não estiverem sendo roteados corretamente, verifique suas regras de encaminhamento e aguarde o tempo para as atualizações do DNS.
**O widget de chat ainda mostra o antigo subdomínio.** Limpe o cache do seu navegador e verifique se você está usando o [código do widget atualizado](https://support.zendesk.com/hc/en-us/articles/4408845973914) do seu novo subdomínio.
**Chamadas de API retornando erros 401.** Verifique se você atualizou tanto o URL do endpoint quanto quaisquer tokens de autenticação que possam ser específicos do subdomínio.
**Loops de login do SSO.** O URL do Access Consumer em sua configuração de SSO deve corresponder exatamente ao seu novo subdomínio. Mesmo um pequeno erro de digitação aqui causa falhas de autenticação.
**Imagens ausentes em tickets antigos.** Este é o [comportamento esperado](https://support.zendesk.com/hc/en-us/articles/4408845973914). Você vai querer entrar em contato com o [Suporte Zendesk](https://support.zendesk.com) se precisar de assistência com anexos específicos.
**Falhas de autenticação de integração.** As integrações baseadas em OAuth geralmente precisam de reautorização após alterações de subdomínio. Desconecte completamente e reconecte novamente.
## Quando considerar o host mapping em vez disso
Se este processo parece opressor, o host mapping pode ser a melhor escolha. Ele oferece branding profissional sem a dor de cabeça operacional.
Com o host mapping, você manterá seu subdomínio Zendesk existente internamente. Seus agentes continuam usando `suaempresa.zendesk.com`. Os clientes veem `support.suaempresa.com` ou `help.suaempresa.com`.
Os benefícios são significativos:
- Nenhuma quebra de integração
- Nenhuma alteração de endpoint da API
- Nenhuma alteração de endereço de e-mail
- Nenhum tempo de inatividade
- Nenhuma limpeza pós-alteração
Você obtém a aparência profissional sem tocar em nenhum dos seus sistemas de backend.
Configurar o host mapping envolve criar um [registro CNAME](https://support.zendesk.com/hc/en-us/articles/4408838571930) com seu provedor de DNS e configurar certificados SSL no Zendesk. Todo o processo normalmente leva menos de uma hora, a maior parte do qual é esperar pela propagação do DNS.
Se você estiver gerenciando [várias marcas no Zendesk](https://support.zendesk.com/hc/en-us/articles/4408838571930), o host mapping se torna ainda mais valioso. Cada marca pode ter seu próprio domínio personalizado sem a complexidade de várias renomeações de subdomínio.
Nosso [agente de IA Zendesk](https://www.eesel.ai/product/ai-agent) funciona perfeitamente com domínios com host mapping, fornecendo suporte consistente alimentado por IA, independentemente de qual URL seus clientes usam para entrar em contato com você.
## Planejando sua alteração de subdomínio Zendesk
Se você decidiu que uma renomeação de subdomínio é necessária, trate-a como um pequeno projeto. Crie um cronograma com proprietários específicos para cada atualização de integração. Teste o que você puder em um ambiente sandbox primeiro. Você vai querer comunicar a alteração aos clientes com bastante antecedência, especialmente se seu endereço de e-mail de suporte for alterado.
A chave é a preparação. A renomeação real leva segundos. O trabalho está no antes e depois. Coloque sua lista de verificação em ordem, agende durante as horas de baixo volume e tenha sua equipe pronta para lidar com a limpeza pós-alteração.
Lembre-se: se você está preocupado principalmente com o branding voltado para o cliente, o host mapping resolve esse problema sem nenhuma das interrupções operacionais.
Se você está procurando aprimorar sua configuração Zendesk além da configuração de URL, nossas ferramentas de suporte alimentadas por IA se integram perfeitamente com instâncias Zendesk padrão e com host mapping. Confira nossos [preços](https://www.eesel.ai/pricing) para ver como a assistência de IA pode complementar suas operações de suporte.
Compartilhe esta postagem
Article by
