Você precisa ser o responsável pela conta para renomear um subdomínio. Se não for você, é possível encontrar o responsável pela conta e solicitar essa alteração. Não é possível renomear o subdomínio de uma conta sandbox.
A Zendesk não pode alterar o subdomínio da sua conta por você. Se não conseguir encontrar o responsável pela conta, trabalhe com os administradores de TI. Caso não consiga resolver o problema, entre em contato com o Suporte ao cliente Zendesk para iniciar a análise de segurança.
A renomeação do seu subdomínio entra em vigor imediatamente. A conta do Zendesk não estará mais em sua URL antiga, e o Zendesk não pode configurar um redirecionamento em seu nome. Leve todo o seu fluxo de trabalho em consideração antes de fazer a mudança.
Este artigo mostra as seguintes considerações e atualizações que você terá de fazer:
Fatores importantes antes de você renomear o subdomínio
Antes de renomear seu subdomínio, sugerimos que você altere o nome da conta ou configure o mapeamento do host como alternativas.
O mapeamento do host (a compra de outro domínio que aponte para o seu Zendesk) é altamente recomendado como uma alternativa à renomeação do seu subdomínio. Ele permite que você altere a URL que seus clientes veem quando acessam sua central de ajuda sem ter que alterar o endereço real da interface do seu agente ou da conta do Zendesk. Consulte Mapeamento do host - alteração da URL da sua central de ajuda.
- A renomeação do seu subdomínio entra em vigor de imediato, por isso é recomendável fazer a alteração durante um horário de baixo volume ou após o horário de operação porque algumas funcionalidades são afetadas.
- A renomeação do seu subdomínio muda a URL da sua central de ajuda (por exemplo, de meuantigosubdominio.zendesk.com/hc para meunovosubdominio.zendesk.com/hc). Pode ser necessário atualizar os links ou marcadores que fazem referência à antiga URL da central de ajuda para garantir que os usuários consigam acessar o site correto. Além disso, você deve comunicar essa mudança aos seus clientes para evitar confusão.
- Pode haver um atraso de várias horas antes que você possa adicionar novos endereços de suporte nativos. Ao adicionar um endereço de suporte, verifique se o novo subdomínio aparece no formulário “Criar um novo endereço de suporte”. Se o subdomínio antigo aparecer, verifique novamente em algumas horas.
- O Chat pode ficar inacessível por até 2 horas depois da mudança do subdomínio. É altamente recomendável que você altere seu subdomínio fora do horário de expediente.
- Se você tem uma conta independente do Sell ou uma conta do Sell+Chat , não é possível alterar o subdomínio na Central de administração. Para obter ajuda, entre em contato com o Suporte ao cliente Zendesk.
- Se você usa o Sunshine Conversations pelo Espaço de trabalho do agente e quiser alterar seu subdomínio, precisa apagar e recriar as integrações do Sunshine Conversations. Recomendamos usar os domínios mapeados por host em vez de alterar um subdomínio. Observe que todas as atividades de resposta automática e de bot do Zendesk param de funcionar quando você altera o subdomínio. Se você deseja manter as atividades do bot do Zendesk, não altere o subdomínio.
- Clientes que utilizam o Conector SMTP autenticado precisarão descontinuar o uso antes de renomear seus respectivos subdomínios e adicionar novamente a configuração desejada quando a alteração do subdomínio for concluída, pois esse recurso é específico do subdomínio e não será atualizado automaticamente.
- O acesso a vários programas de acesso antecipado (EAPs) é controlado pelo subdomínio da conta. Se você alterar seu subdomínio, perderá o acesso aos EAPs controlados dessa maneira. É necessário cadastrar-se novamente nesses EAPs com o novo subdomínio.
- A alteração de seu subdomínio quebrará os links para imagens embutidas nos tickets, pois essas imagens incluem seu subdomínio ou nome do mapa do host na URL.
- Depois que você muda o domínio, não pode mais copiar e colar comentários (internos ou públicos) nem imagens de um ticket criado no domínio antigo. Fazer isso resulta em imagens corrompidas e comentários incompletos. Você precisa recriar os comentários ou recarregar os anexos de imagens diretamente no ticket no novo domínio.
Etapa 1: tarefas a fazer antes de renomear seu subdomínio
Antes de renomear seu subdomínio, você deve atualizar os itens a seguir:
Encaminhamento de e-mail de endereços externos
Você precisa atualizar qualquer encaminhamento de e-mail para indicar seu novo endereço de suporte e URL em sincronia com a renomeação do subdomínio para evitar a perda de tickets recebidos. Isso inclui a opção de e-mail curinga (consulte Aceitação de endereços de e-mail curingas para solicitações de suporte). Você deve ativar o recurso durante um período calmo para que tenha tempo de colocar tudo em ordem.
Pontos a considerar:
- Você é responsável por migrar endereços externos. O Zendesk não é capaz de migrar endereços externos automaticamente.
- Garanta que todos os endereços externos encaminhem para o novo subdomínio e remova todas as regras de encaminhamento para o subdomínio antigo.
- Se você encaminha e-mails de vários endereços externos para vários endereços do Zendesk, precisa consolidar temporariamente o tráfego de e-mails em seu endereço de suporte padrão (suporte@novo_subdomínio.zendesk.com) ou ativar curingas. Embora possa levar várias horas antes que seja possível adicionar novos endereços de suporte nativos usando o novo domínio, o endereço padrão suporte@novo_subdomínio.zendesk.com fica disponível imediatamente.
CNAME, mapas do host e SSL
Atualize quaisquer mapeamentos do host para indicar o novo endereço de suporte e URL. Garanta que as mudanças no CNAME e as atualizações do certificado sejam feitas com sua equipe de atendimento ao cliente antes da alteração do subdomínio. É necessário adicionar um novo CNAME para seu novo subdomínio do Zendesk com uma nova URL de mapa do host. Além disso, será necessário configurar um redirecionamento de seu antigo mapa do host para o novo. Essa configuração pode demorar.
Você pode obter um novo certificado SSL ao conseguir uma solicitação de assinatura de certificado e, então, fazer o upload do novo certificado no Zendesk Support. Você precisa instalar um novo certificado SSL que abranja a URL alterada mapeada por host. Para obter mais informações, consulte Como substituir seu certificado SSL atual.
JIRA
Se você ativou a integração Jira OnDemand, precisará atualizar seu Jira antes de mudar o subdomínio.
- Em Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Aplicativos > Aplicativos de canal. - Desative o aplicativo do Jira.
- Renomeie seu subdomínio.
- Ative o conector novamente no Jira.
- Selecione a opção Configure nas definições do conector.
- Na próxima tela, clique em Complete set-up para instalar o aplicativo.
- Siga as instruções na tela.
- Volte ao Zendesk Support e verifique se o aplicativo Jira OnDemand carrega normalmente.
Seus tickets/problemas vinculados ao Zendesk Support e Jira não serão perdidos nesse processo. Estamos apenas autorizando novamente o aplicativo do Zendesk.
Se você usava credenciais OAuth vinculadas ao seu antigo subdomínio, talvez também seja necessário atualizar seus outros aplicativos.
Etapa 2: renomear seu subdomínio
Siga estas etapas para renomear seu subdomínio. Você precisa ser o responsável pela conta para renomear um subdomínio. Se não for você, é possível encontrar o responsável pela conta e solicitar essa alteração.
A Zendesk não pode alterar o subdomínio da sua conta por você. Se não conseguir encontrar o responsável pela conta, trabalhe com os administradores de TI. Caso não consiga resolver o problema, entre em contato com o Suporte ao cliente Zendesk para iniciar a análise de segurança.
Como renomear o subdomínio
- Na Central de administração, clique em
Conta na barra lateral e selecione Aparência > Personalização. - Na seção Subdomínio, clique em Mudar seu subdomínio.
Observação: se você usa várias marcas, clique no menu Marcas em vez de Mudar seu subdomínio. - Digite seu novo subdomínio na caixa de diálogo conforme mostrado a seguir.
- Confirme as alterações clicando em Renomear subdomínio.
Para visualizar a alteração, atualize seu navegador.
A boa notícia é que nem tudo muda quando você atualiza o subdomínio. Todos seus usuários, tickets, organizações e grupos existentes estarão presentes automaticamente em sua nova URL. Além disso, seus gatilhos e automações serão definidos. Ainda que seus usuários precisem entrar novamente em seu novo local do Zendesk, seus perfis e históricos de ticket permanecem intactos.
Conclua as tarefas na seção a seguir depois de mudar o seu subdomínio.
Etapa 3: tarefas a fazer depois de renomear seu subdomínio
Após renomear seu subdomínio, você deve atualizar os itens a seguir:
- Contrato de compartilhamento de ticket
- Representação de CSAT/Web Widget (clássico)
- Respostas de tickets
- SDK para dispositivos móveis
- Zendesk Talk
- Credenciais/tokens da API
- Single sign-on
- Mensagens do Zendesk
- Zendesk Chat
- Gerenciamento da força de trabalho (WFM) do Zendesk
- Notificações de status
- Explore
Contrato de compartilhamento de ticket
Se você tiver algum contrato de compartilhamento de ticket ativo, precisará desativar e recriá-lo depois de mudar seu subdomínio. Isso inclui o recebimento de qualquer contrato de compartilhamento de ticket, o que significa que também será necessário que os administradores dessas contas do Zendesk recriem seus contratos de compartilhamento para atualizar a localização de sua conta do Zendesk.
Compartilhar tickets individuais também não funcionará mais. Depois de renomear seu subdomínio e atualizar seu contrato de compartilhamento, você terá que atualizar manualmente todos os tickets compartilhados para refletir o novo contrato de compartilhamento.
Representação de CSAT/Web Widget (clássico)
Se você está usando uma ou mais instâncias do Web Widget (clássico), precisa atualizá-las antes de alterar o subdomínio. Também será necessário atualizar seu jQuery se você tiver feito modificações em sua representação de CSAT. Para obter mais informações sobre como atualizar seus índices de satisfação no formato JSON, consulte Exibição de seus 100 últimos índices de satisfação.
Você deve atualizar os widgets de sua central de ajuda e de seu website individualmente depois de mudar o nome do subdomínio.
- Na Central de administração, clique em
Canais na barra lateral e selecione Clássico > Web Widget. - Clique na aba Configuração, se ela ainda não estiver selecionada.
- Na caixa do código, clique em Copiar para área de transferência.
- Para editar o widget em seu website, acesse a página da web onde você quer adicionar o widget e cole o código atualizado antes de fechar a marca HTML </HEAD>. É necessário adicionar o código a todas as páginas da web onde deseja atualizar o widget.
- Na central de ajuda, clique em Painel de personalização no painel de ferramentas e em Editar.
- Selecione o modelo de Cabeçalho na lista suspensa.
- Apague todos os códigos existentes de widget da central de ajuda que você tiver.
- Cole o código atualizado antes da marca </HEADER>;.
- Clique em Salvar e em Publicar alterações.
Para obter informações sobre a atualização de seus widgets, consulte Uso do Web Widget (clássico) para incorporar o atendimento ao cliente no seu website.
Respostas de tickets
Se você usa notificações por e-mail, as respostas do cliente para as notificações de ticket enviadas antes da mudança do subdomínio não serão recebidas em sua conta ou adicionadas como atualizações desses tickets. Todas as URLs do ticket enviadas nas notificações por e-mail antes da mudança do subdomínio agora também serão inválidas. Para corrigir isso, você precisará atualizar todas com um comentário público após fazer a mudança de subdomínio.
Comece criando uma visualização de todos os tickets não resolvidos na sua instância do Zendesk Support. Se você ainda não fez muitas personalizações, já pode ter essa visualização nativa funcionando em sua conta.
Dessa visualização, você pode fazer a edição em massa de todos os seus tickets com os comentários que desejar. O novo endereço de resposta será válido e, se você usar o placeholder {{ticket.URL}}, ele será preenchido com a URL atualizada do ticket.
SDK para dispositivos móveis
Será necessário atualizar o código em seu SDK para dispositivos móveis para ele indicar a URL do Zendesk correta depois que você atualizar o subdomínio.
- Na Central de administração, clique em Canais e selecione Clássico> SDK para dispositivos móveis.
- Localize o trecho do código com o subdomínio em seu código de Android ou iOS.
- Forneça os trechos do código atualizados a seu desenvolvedor.
Zendesk Talk
Se você está enfrentando problemas com o Zendesk Talk depois de mudar o subdomínio, envie uma solicitação para o Suporte ao cliente Zendesk.
Autenticação da API
Se você usa a API do Zendesk para buscar e enviar dados em sua conta, atualize o subdomínio para o qual está apontando, assim a chamada da API não falhará.
Por exemplo:
https://{OLDsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password}
https://{NEWsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password}
Se o seu endereço de e-mail ou de seus agentes mudou, pode ser necessário atualizar seus tokens da API ou suas credenciais. Para obter mais informações, consulte Gestão de acesso à API do Zendesk.
Single sign-on
Tanto SAML e JWT passam a solicitação de SSO para a URL do Consumidor de Asserção do Zendesk, que se refere ao subdomínio da sua conta. Não é possível entrar por SSO até que você atualize o subdomínio.
Para obter mais informações sobre a configuração de SSO, consulte Ativação de single sign-on com SAML e Configuração de single sign-on com JWT (Token da web JSON).
Mensagens do Zendesk
Quando você muda o subdomínio, um novo script do Web Widget de mensagens é gerado. Você precisa atualizar todas as páginas do site ou aplicativo para usar o novo script. Consulte Instalação do Web Widget em um website.
Zendesk Chat
Se você comprou o Chat separadamente e depois vinculou sua conta do Chat à sua conta do Support, a conta do Chat não criará tickets. Entre em contato com a equipe de atendimento ao cliente para fazer as alterações necessárias para resolver o problema.
Se você comprou o Zendesk Chat e o Zendesk Support juntos, as atualizações acontecem automaticamente e nenhuma ação é necessária.
Gerenciamento da força de trabalho (WFM) do Zendesk
Ao renomear seu subdomínio do Zendesk, renomeie-o no Zendesk WFM para garantir que as contas correspondam e que seus dados históricos e configurações estejam intactos.
Como renomear o subdomínio do Zendesk WFM
- Depois de renomear o subdomínio do Zendesk, entre em contato com o Suporte ao cliente Zendesk e informe seu subdomínio antigo e o novo subdomínio renomeado do Zendesk.
- A Zendesk atualizará seu subdomínio e convidará você a reautorizar a conta.
Notificações de status
Se você assinou as notificações de status do Zendesk, atualize a assinatura com o novo subdomínio.
Explore
Você poderá ver algumas entregas do painel programadas com atraso (ou ausentes) enquanto a conta é ressincronizada com o Explore.