Notificações push do Zammad no seu telemóvel

O Zammad, por si só, não envia notificações push para telemóveis. O Zamio acrescenta-as com duas funcionalidades padrão do Zammad: um webhook e um acionador (trigger). Um administrador do Zammad configura isto uma única vez, e demora cerca de cinco minutos. Funciona com o Zammad 6 e 7, em servidor próprio ou no Zammad Cloud.

Como funciona

Alteração num ticket Acionador do Zammad Webhook assinado Serviço de notificações Zamio Apple / Google Telemóveis dos agentes

Há duas definições que determinam o que acontece:

  • O acionador decide quando. Só é enviada uma notificação quando as condições do acionador se verificam.
  • O grupo do ticket decide quem. A notificação chega a todos os agentes do grupo do ticket que usam o Zamio com as notificações ativadas. Quem fez a alteração não a recebe.

Passo 1: Registe o seu servidor Zammad

  1. Abra notification.zamio.kaju.pl/setup.html.
  2. Em Zammad Server URL, introduza o endereço do seu Zammad, por exemplo https://suporte.empresa.pt. Use exatamente o endereço que os agentes escrevem ao iniciar sessão na aplicação (ver resolução de problemas).
  3. Em HMAC Signature Token, invente um segredo com pelo menos 8 caracteres. Vai colar o mesmo valor no Zammad no passo 2.
  4. Clique em Register Server e copie o URL do webhook. Tem este aspeto:
    https://notification.zamio.kaju.pl/webhook/group?server=https://suporte.empresa.pt

O servidor fica a aguardar verificação. É confirmado automaticamente quando chegar do seu Zammad o primeiro webhook corretamente assinado.

Passo 2: Crie o webhook no Zammad

  1. No Zammad, vá a Gerir (Manage) → Webhook → Novo webhook.
  2. Nome: por exemplo Zamio push.
  3. Endpoint: cole o URL do passo 1.
  4. Token de assinatura (Signature Token): o mesmo segredo que introduziu no passo 1.
  5. Mantenha a Verificação SSL ativada.
  6. Mantenha o Payload personalizado (Custom Payload) desativado. O serviço lê o payload padrão do Zammad (ticket e artigo).
  7. Guarde.

Passo 3: Crie os acionadores

Um acionador que dispara em cada alteração de um ticket enche os agentes de notificações. Eu configuro-o para três situações que justificam interromper alguém:

SituaçãoCondições do acionador
Um ticket chega a um grupoGrupo foi alterado
Um ticket muda de estadoEstado foi alterado
O cliente respondeArtigo › Ação é criado, e Artigo › Remetente é Cliente

As condições dentro de um acionador do Zammad são combinadas com E (AND), por isso o mais simples é criar três acionadores, um por linha. Se conhece o modo avançado (expert mode) do Zammad, pode juntá-las num só acionador com OU (OR).

Para cada acionador:

  1. Vá a Gerir (Manage) → Acionador (Trigger) → Novo acionador.
  2. Ativado por (Activated by): Ação.
  3. Adicione as condições da tabela.
  4. Em Executar alterações nos objetos (Execute changes on objects), escolha Notificação → Webhook e selecione Zamio push.
  5. Guarde.

Passo 4: Ative as notificações na aplicação

Cada agente abre Configurações → Notificações push no Zamio e permite as notificações quando o telemóvel o pedir. O telemóvel fica então registado para o servidor Zammad em que o agente tem sessão iniciada.

Passo 5: Teste

Peça a um colega que responda a um ticket do seu grupo, ou inicie sessão no Zammad no browser com outro utilizador. Não recebe notificações das suas próprias alterações, por isso alterar um ticket e ficar à espera da notificação é o falso alarme mais comum.

Resolução de problemas

Ninguém recebe notificações
Verifique o endereço do servidor. As notificações são associadas pelo endereço exato: https ou http, outro subdomínio ou uma porta contam como servidores diferentes. Se registou https://zammad.empresa.pt mas os agentes iniciam sessão em https://suporte.empresa.pt, nada corresponde. Registe o endereço que os agentes usam de facto.
O Zammad mostra um erro ao enviar o webhook
Provavelmente o token de assinatura no Zammad é diferente do segredo introduzido na página de configuração. Se o servidor nunca foi confirmado, registe-o novamente com um novo segredo. Se já foi confirmado, a página de configuração recusa um novo registo. Escreva para kontakt@kaju.pl e eu reponho-o.
Um agente não recebe notificações
O agente tem de ser membro do grupo do ticket no Zammad. No telemóvel, confirme que as notificações do Zamio estão permitidas nas definições do sistema e depois desative e volte a ativar as notificações na aplicação.
Ativei o Payload personalizado
Desative-o. Sem os objetos padrão ticket e article, o serviço não consegue criar a notificação e rejeita o webhook.
Uso dois servidores Zammad
Só recebe notificações do servidor em que tem sessão iniciada na aplicação nesse momento.