Iniciar sessão no Zammad com um token de API

Escrito por Michał, criador do Zamio · Atualizado:

O Zamio inicia sessão no Zammad com um token de API pessoal em vez de uma palavra-passe. Introduz-o uma vez e deixa de pensar no início de sessão. Esta página explica o que o administrador tem de ativar e o que cada agente faz.

Porquê um token e não uma palavra-passe

Escolhi tokens por segurança e porque é a opção mais prática num telemóvel:

  • A sua palavra-passe nunca passa pela aplicação. Também funciona se iniciar sessão no Zammad por SSO ou usar autenticação de dois fatores.
  • Permissões limitadas. O token recebe apenas ticket.agent, e isso chega para tudo o que a aplicação faz.
  • Pode revogá-lo a qualquer momento no Zammad sem mudar a palavra-passe, por exemplo se perder o telemóvel.
  • Fica no dispositivo. O token é guardado no Keychain do iOS ou no Keystore do Android. Não é guardado em nenhuma nuvem. A aplicação liga-se diretamente do seu telemóvel ao Zammad da sua empresa.

Para administradores: permitir o acesso por token

  1. No Zammad, abra as definições de administração (ícone da roda dentada) e vá a Configurações → Sistema → API.
  2. Ative o Acesso por token de API (API Token Access).

Se um agente continuar a não ver Acesso por token no perfil, confirme que a sua função tem a permissão user_preferences.access_token (Gerir (Manage) → Funções (Roles)).

Para agentes: criar um token

  1. No Zammad, no browser, clique nas suas iniciais ou no avatar no canto inferior esquerdo e escolha Perfil → Acesso por token.
  2. Clique em Criar.
  3. Nome: algo que indique onde é usado, por exemplo Zamio – iPhone.
  4. Permissões: marque ticket.agent.
  5. Data de expiração: opcional. Sem ela, o token funciona até o apagar.
  6. Clique em Criar e copie logo o token. O Zammad só o mostra uma vez.

Dica: abra o Zammad no browser do próprio telemóvel e crie lá o token. Assim basta colá-lo na aplicação, sem ter de o enviar a si próprio por email ou chat.

Iniciar sessão no Zamio

  1. URL do servidor: o endereço que usa para o Zammad no browser, por exemplo https://suporte.empresa.pt, sem nada depois do domínio.
  2. Token de API: cole o token.

Já está. Mantém a sessão iniciada até terminar sessão ou até o token expirar ou ser apagado.

Telemóvel perdido ou colaborador que sai

Apague o token no Zammad em Perfil → Acesso por token. A aplicação perde imediatamente o acesso ao Zammad. A conta e a palavra-passe não mudam.

Resolução de problemas

“Token de API inválido”
O token foi copiado incompleto, expirou ou foi apagado. Não é possível voltar a ver um token existente, por isso crie um novo e apague o antigo.
Não vejo “Acesso por token” no meu perfil
O administrador não ativou o acesso por token de API, ou a sua função não tem user_preferences.access_token. Veja a secção para administradores acima.
A aplicação não consegue ligar-se ao servidor
Verifique o endereço: https:// no início, nenhum caminho depois do domínio, e o mesmo endereço que usa no browser. Se o Zammad só estiver acessível na rede da empresa ou por VPN, o telemóvel também tem de estar nessa rede.
Faltam tickets ou grupos
A aplicação vê exatamente o que a sua conta Zammad vê. Se faltar alguma coisa, verifique os seus grupos e funções no Zammad.

Depois de iniciar sessão, o passo seguinte é configurar as notificações push.