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
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
- Abra notification.zamio.kaju.pl/setup.html.
- 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). - Em HMAC Signature Token, invente um segredo com pelo menos 8 caracteres. Vai colar o mesmo valor no Zammad no passo 2.
- 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
- No Zammad, vá a Gerir (Manage) → Webhook → Novo webhook.
- Nome: por exemplo
Zamio push. - Endpoint: cole o URL do passo 1.
- Token de assinatura (Signature Token): o mesmo segredo que introduziu no passo 1.
- Mantenha a Verificação SSL ativada.
- Mantenha o Payload personalizado (Custom Payload) desativado. O serviço lê o payload padrão do Zammad (ticket e artigo).
- 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ção | Condições do acionador |
|---|---|
| Um ticket chega a um grupo | Grupo foi alterado |
| Um ticket muda de estado | Estado foi alterado |
| O cliente responde | Artigo › 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:
- Vá a Gerir (Manage) → Acionador (Trigger) → Novo acionador.
- Ativado por (Activated by): Ação.
- Adicione as condições da tabela.
- Em Executar alterações nos objetos (Execute changes on objects), escolha Notificação → Webhook e selecione
Zamio push. - 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:
httpsouhttp, outro subdomínio ou uma porta contam como servidores diferentes. Se registouhttps://zammad.empresa.ptmas os agentes iniciam sessão emhttps://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
ticketearticle, 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.