Principal Integrações com Helpdesks [Zendesk] Editando sua Integração com a Claudia

[Zendesk] Editando sua Integração com a Claudia

Última atualização em Aug 31, 2025

Este guia explica como e por que modificar as configurações da sua integração Zendesk existente com a Claudia através da tela de Edição no Hub. Use esta tela para atualizar informações que podem ter mudado ou para corrigir configurações anteriores.

1. Acessando a Tela de Edição

  • Você encontrará a opção de editar uma integração existente em "Integração" no Hub.

2. Campos Editáveis e Onde Encontrar as Informações:

Aqui está uma descrição dos campos que você pode editar e onde encontrar os dados atualizados no Zendesk, caso precise alterá-los:

Subdomínio do Zendesk:

  • O que é: Identifica sua conta específica do Zendesk.

  • Porque editar: Se o subdomínio da sua conta Zendesk foi alterado.

  • Onde encontrar: É a parte inicial da URL que você usa para acessar o Zendesk. Exemplo: https://[subdomínio].zendesk.com.

Usuário (E-mail de acesso):

  • O que é: O endereço de e-mail da conta Zendesk usada para autenticar a conexão da API.

  • Porque editar: Se o e-mail do usuário administrador associado à integração mudou, ou se você precisa usar uma conta diferente (por exemplo, por motivos de permissão).

  • Onde encontrar: É o e-mail que você utiliza para fazer login no Zendesk (geralmente uma conta de administrador ou uma conta dedicada à integração com as permissões corretas).

Token / API Key:

  • O que é: A chave secreta que autoriza a Claudia a se comunicar com a API do Zendesk em seu nome.

  • Porque editar: Se o token anterior foi revogado, expirou, se tornou inválido, ou se você gerou um novo por motivos de segurança.

  • Onde encontrar: No Zendesk, vá em Central de administração > Aplicações e integrações > API > API do Zendesk. Se você não tem mais o token antigo (ele só é exibido na criação), você precisará gerar um novo token ativo e colá-lo aqui.

ID do Grupo da Claudia (Opcional):

  • O que é: O identificador numérico do grupo no Zendesk que você pode ter designado para a Claudia operar.

  • Porque editar: Se você decidiu usar um grupo diferente para a Claudia ou se você deixou em branco na configuração inicial e agora deseja designar um grupo específico.

  • Onde encontrar: No Zendesk, vá em Central de administração > Pessoas > Grupos. Clique no nome do grupo desejado e copie a parte numérica da URL da página (após groups/).

Grupo para transbordo (N2):

  • O que é: O identificador numérico do grupo no Zendesk para onde a Claudia deve encaminhar os tickets quando precisar escalar para um atendimento humano.

  • Porque editar: Se a equipe ou o grupo responsável pelo atendimento N2 mudou, ou se você reorganizou seus grupos no Zendesk e precisa apontar para o novo grupo correto.

  • Onde encontrar: No Zendesk, vá em Central de administração > Pessoas > Grupos. Clique no nome do grupo de N2 desejado e copie a parte numérica da URL da página (após groups/).

Configurações Adicionais para o Chat (Opcional):

Estes campos só são relevantes se você estiver usando a integração de chat (conversas em tempo real).

  • ID do Aplicativo: Identificador da sua integração de conversas no Zendesk.

  • ID da Chave: Identificador da chave de API específica para a integração de conversas.

  • Chave Secreta: Chave secreta associada ao ID da Chave para autenticar a integração de conversas.

  • Porque editar: Se você gerou novas credenciais (ID da Aplicação, ID da Chave, Chave Secreta) para a sua integração de conversas no Zendesk, se as anteriores foram revogadas/comprometidas.

  • Onde encontrar: No Zendesk, na Central de administração, navegue até a seção de Aplicações e integrações > Conversas e integrações. Localize a integração relevante e suas Chaves de API. Lembre-se que a Chave Secreta geralmente só é visível no momento da criação; se perdida, talvez precise gerar uma nova chave.

3. Salvando as Alterações

  • Após modificar qualquer um dos campos acima, certifique-se de clicar no botão "Salvar Integração".

  • As suas edições só terão efeito depois de serem salvas.

4. Testando Após a Edição

  • Fundamental: Depois de salvar qualquer alteração, é crucial testar a integração novamente.

  • Envie uma mensagem de teste (e-mail ou chat, dependendo da configuração) para verificar se os tickets ainda são criados/respondidos corretamente pela Claudia e se o transbordo para o grupo N2 está funcionando conforme as novas configurações.