Configurando Oauth na Zendesk - Para o Auto Login na 55PBX

Nesse artigo iremos mostrar como configurar o cliente Oauth na Zendesk. Este processo é necessário para que a 55PBX, consiga se logar automaticamente assim que o usuário se logar no Zendesk. Para saber como habilitar o Auto login na 55pbx, clique aqui.

Basta seguir os passos abaixo para configurar corretamente o cliente Oauth

1° Acessar sua conta de Admin na Zendesk

2º Ir em Configurações
Após logar corretamente clique na engrenagem, para ir até a Central de administração como mostra a imagem abaixo:

3º Ir até Aplicativos e Integrações
Após acessar a Central de Administração,  vá em Aplicativos e integrações > Api's do Zendesk > Clientes Oauth

A seguir, clique em "Adicionar cliente Oauth" destacado abaixo:

A partir deste ponto, você estará efetivamente configurando o token da integração, portanto será necessário preencher os campos da seguinte maneira:

• Nome do cliente: O nome de seu cliente, exibido para os usuários quando a concessão de acesso ao seu aplicativo for solicitada ou ao visualizar a lista de aplicativos aos quais o acesso foi concedido.
  
  
• Descrição: Uma curta descrição do seu cliente, exibida para os seus usuários quando eles estiverem decidindo se concederão acesso ao seu aplicativo.
  
  
• Empresa: Esse nome é exibido quando for solicitado que os usuários concedam acesso ao seu aplicativo. O nome ajuda os usuários a entender para quem eles estão concedendo acesso.
  
  
• Logotipo: Escolha uma imagem (JPG ou PNG) a ser exibida quando for solicitado que os usuários concedam acesso ao seu aplicativo.
  
  
  
• Identificador Exclusivo: Esse é o nome do seu cliente, usado no código. Exemplo: meu_app_legal. Esse identificador não é exibido aos usuários do Zendesk. Você pode alterar a sugestão inicial. Identificadores com um prefixo zdg- são reservados para clientes Oauth globais.
  
  

  OBS: Como esse código é exclusivo para cada aplicativo que integra com a Zendesk, no caso da 55PBX é OBRIGATÓRIO preencher como 55pbx_oauth_integration

   
• Url's de Redirecionamento: Especifique as URLs que o Zendesk deve usar para redirecionar os usuários depois que eles decidirem se permitirão que seu aplicativo acesse ou não o Zendesk. As URLs devem ser absolutas e não relativas, https (a menos que sejam localhost ou 127.0.0.1) e separadas por linhas.
  
  
  OBS: Assim como o identificador exclusivo, as URL's de redirecionamento, são exclusivas por aplicativo, no caso da 55PBX, devemos adicionar uma URL por linha da maneira descrita abaixo:
  
  URL 1:  https://fone.55pbx.com:8503/oauth/redirect/(Seu dominio deve ser substituido aqui)
  
  Exemplo: Para descobrir o seu domínio, basta analisar sua URL zendesk e copiar o que vem antes  .zendesk.com.
  
  Se sua URL for 1234.zendesk.com, seu dominio será 1234, logo a url deverá ficar: https://fone.55pbx.com:8503/oauth/redirect/1234
  
  URL 2:  https://fone.55pbx.com:8503/oauth/redirect
  
  URL3:  https://admin.55pbx.com:3001/oauth/send/script

Após as alterações feitas a tela preenchida, ficará semelhante a essa:


Com as alterações feitas, basta clicar em Salvar, após salvar, irá aparecer a seguinte mensagem:

Clique em "OK", após esse passo, será apresentado um "Segredo", você deve copiar e salvar o código apresentado no segredo:

Após guardar o segredo em um local seguro (Ele não será apresentado outra vez, se perder este código, será necessário refazer todo o processo) clique em Salvar.

Pronto! Você acabou de configurar corretamente o token de Oauth da Zendesk, para poder utilizar o Auto Login da 55PBX!
Para saber como habilitar o auto login na 55PBX, clique AQUI.

Caso ainda possuam dúvidas, por favor, não hesitem em nos contatar!

Att
Equipe 55PBX