Push-сповіщення Zammad на вашому телефоні

Автор: Міхал, розробник Zamio · Оновлено: 2026-11-09

Сам Zammad не надсилає push-сповіщення на телефони. Zamio додає їх за допомогою двох стандартних функцій Zammad: вебхука і тригера. Адміністратор Zammad налаштовує це один раз, і це займає приблизно п'ять хвилин. Працює з Zammad 6 і 7, на власному сервері або в Zammad Cloud.

Як це працює

Зміна в заявці Тригер Zammad Підписаний вебхук Сервіс сповіщень Zamio Apple / Google Телефони агентів

Усе визначають два налаштування:

Тригер визначає, коли. Сповіщення надсилається лише тоді, коли виконуються умови тригера.
Група заявки визначає, кому. Сповіщення отримує кожен агент із групи заявки, який користується Zamio з увімкненими сповіщеннями. Людина, яка внесла зміну, його не отримує.

Крок 1: Зареєструйте свій сервер Zammad

Відкрийте notification.zamio.kaju.pl/setup.html.
У полі Zammad Server URL введіть адресу свого Zammad, наприклад https://support.company.ua. Це має бути саме та адреса, яку агенти вводять під час входу в додаток (див. вирішення проблем).
У полі HMAC Signature Token придумайте секрет щонайменше з 8 символів. Те саме значення ви вставите в Zammad на кроці 2.
Натисніть Register Server і скопіюйте URL вебхука. Він виглядає так:
https://notification.zamio.kaju.pl/webhook/group?server=https://support.company.ua

Тепер сервер очікує підтвердження. Він підтвердиться автоматично, коли з вашого Zammad надійде перший правильно підписаний вебхук.

Крок 2: Створіть вебхук у Zammad

У Zammad перейдіть до Керування → Вебхуки → Новий вебхук (Manage → Webhook → New Webhook).
Назва: наприклад Zamio push.
Endpoint: вставте URL із кроку 1.
Токен підпису (Signature Token): той самий секрет, що й на кроці 1.
Залиште увімкненою перевірку SSL (SSL Verification).
Залиште вимкненим власний payload (Custom Payload). Сервіс читає стандартні дані Zammad (заявку та статтю).
Збережіть.

Крок 3: Створіть тригери

Тригер, що спрацьовує на кожну зміну в заявці, засипле агентів сповіщеннями. Я налаштовую його на три ситуації, заради яких варто когось відволікти:

Ситуація	Умови тригера
Заявка потрапляє до групи	`Group` has changed
Заявка змінює стан	`State` has changed
Клієнт відповідає	`Article › Action` is created, і `Article › Sender` is Customer

Умови в одному тригері Zammad поєднуються через «І», тож найпростіше створити три тригери, по одному на рядок. Якщо ви знаєте експертний режим Zammad, можна об'єднати їх в один тригер з «АБО».

Для кожного тригера:

Перейдіть до Керування → Тригери → Новий тригер (Manage → Trigger → New Trigger).
Активується (Activated by): Action.
Додайте умови з таблиці.
У розділі Виконати зміни в об'єктах (Execute changes on objects) оберіть Notification → Webhook і виберіть Zamio push.
Збережіть.

Крок 4: Увімкніть сповіщення в додатку

Кожен агент відкриває в Zamio Налаштування → Push-сповіщення і дозволяє сповіщення, коли телефон про це запитає. Після цього телефон реєструється для сервера Zammad, на якому агент авторизований.

Крок 5: Перевірте

Попросіть колегу відповісти в заявці з вашої групи або увійдіть у Zammad у браузері як інший користувач. Про власні зміни ви сповіщень не отримуєте, тому змінити заявку самому й чекати на сповіщення — найчастіша хибна тривога.

Вирішення проблем

Ніхто не отримує сповіщень: Перевірте адресу сервера. Сповіщення зіставляються за точною адресою: https чи http, інший піддомен або порт — це різні сервери. Якщо ви зареєстрували https://zammad.company.ua, а агенти входять через https://support.company.ua, нічого не збігається. Зареєструйте адресу, якою агенти справді користуються.
Zammad показує помилку під час надсилання вебхука: Найімовірніше, токен підпису в Zammad відрізняється від секрету, введеного на сторінці реєстрації. Якщо сервер ще не підтверджено, зареєструйте його знову з новим секретом. Якщо його вже підтверджено, сторінка реєстрації відхилить нову реєстрацію. Напишіть на kontakt@kaju.pl, і я його скину.
Один агент не отримує сповіщень: Агент має бути членом групи заявки в Zammad. На телефоні перевірте, чи дозволені сповіщення для Zamio в системних налаштуваннях, а потім вимкніть і знову увімкніть сповіщення в додатку.
Я увімкнув власний payload (Custom Payload): Вимкніть його. Без стандартних об'єктів ticket і article сервіс не може сформувати сповіщення і відхиляє вебхук.
Я користуюся двома серверами Zammad: Сповіщення надходять лише з сервера, на якому ви зараз авторизовані в додатку.