Довідка Сповіщення

Сповіщення

Ви можете налаштувати різні сповіщення у вашій системі, щоб нагадувати про важливі дії.

  1. Дата завершення Завдання.
  2. Очікувана дата доставки Sales Order.
  3. Очікувана дата оплати.
  4. Нагадування про подальші дії.
  5. Якщо отримано або відправлено Замовлення на суму більше певного значення.
  6. Сповіщення про закінчення терміну дії Контракту.
  7. Завершення/Зміна статусу Завдання.

Щоб отримати доступ до налаштувань сповіщень, перейдіть:

Головна > Налаштування > Сповіщення

  1. Налаштування сповіщення

Щоб налаштувати сповіщення:

  1. Визначте, які події ви хочете відстежувати в полі "Надіслати сповіщення при". Події:

    1. Новий: Коли створено новий документ обраного типу.
    2. Збереження/Відправлення/Скасування: Коли документ обраного типу зберігається, відправляється або скасовується.
    3. Днів до/Днів після: Запустити це сповіщення за кілька днів до або після Дата відліку. Щоб встановити дні, вкажіть Днів до або після. Це може бути корисним для нагадування про майбутні терміни виконання або для нагадування про подальші дії щодо певних потенційних клієнтів або пропозицій.
    4. Зміна значення: Коли змінюється певне значення в обраному типі документа.
    5. Метод: Надсилає сповіщення, коли запускається певний метод. Наприклад: before_insert.
    6. Користувацький: Надіслати сповіщення на обраний Email Account.

  2. Виберіть тип документа, зміни в якому ви хочете відстежувати. Починаючи з Версії 16, ви також можете вибирати дочірні типи документів, якщо для "Надіслати сповіщення при" встановлено значення Днів до або Днів після.

  3. Встановіть додаткові умови, якщо потрібно.

  4. Встановіть одержувачів цього сповіщення. Одержувачем може бути поле документа або список фіксованих адрес електронної пошти.

  5. Складіть повідомлення.

  6. Збережіть.

1.1 Встановлення теми

Ви можете отримати дані для певного поля, використовуючи doc.[field_name]. Щоб використовувати його у темі/повідомленні, вам потрібно оточити його тегами {% raw %}{{ }}{% endraw %}. Вони називаються тегами Jinja. Наприклад, щоб отримати назву документа, використовуйте {% raw %}{{ doc.name }}{% endraw %}. Наступний приклад надсилає електронний лист при збереженні Завдання з темою "Завдання #### створено".

1.2 Встановлення умов

Сповіщення дозволяють встановлювати умови відповідно до даних полів у ваших документах. Наприклад, якщо ви хочете отримати електронний лист, коли потенційний клієнт збережений зі статусом "Зацікавлений", ви вказуєте doc.status == "Зацікавлений" у текстовому полі умов. Ви також можете встановлювати більш складні умови, комбінуючи їх за допомогою оператора і або або.

Наведений вище приклад надішле сповіщення, коли Завдання збережено зі статусом "Відкрито" і "Очікувана дата завершення" для Завдання є датою, яка дорівнює або передує даті, коли воно було збережено.

1.3 Встановлення повідомлення

Ви можете використовувати як теги Jinja ({% raw %}{{ doc.[field_name] }}{% endraw %}), так і HTML-теги в текстовому полі повідомлення.

{% raw %}<h3>Замовлення прострочено</h3>

Транзакція {{ doc.name }} перевищила термін оплати. Будь ласка, вжийте необхідних заходів.

{% if comments %} Останній коментар: {{ comments[-1].comment }} від {{ comments[-1].by }} {% endif %}

<h4>Деталі</h4>
  • Клієнт: {{ doc.customer }}
  • Сума: {{ doc.total_amount }}

{% endraw %}

1.4 Встановлення значення після налаштування сповіщення

Іноді, щоб переконатися, що сповіщення не надсилається кілька разів, ви можете визначити користувацьку властивість (через "Налаштувати форму"), наприклад "Сповіщення надіслано", а потім встановити цю властивість після відправлення сповіщення, вказавши поле Встановити властивість після сповіщення.

Потім ви можете використовувати це як умову в правилах Умова, щоб гарантувати, що листи не надсилаються кілька разів.

1.5 Приклад

  1. Визначення критеріїв
  2. Встановлення одержувачів та повідомлення
  1. Сповіщення у Slack

Якщо ви віддаєте перевагу надсиланню сповіщень у спеціальний канал Slack, ви також можете вибрати опцію "Slack" у параметрах каналу та обрати відповідну URL-адресу вебхука Slack.

2.1 URL-адреса вебхука Slack

URL-адреса вебхука Slack — це URL-адреса, яка вказує безпосередньо на канал Slack.

Щоб створити URL-адреси вебхуків, вам потрібно створити новий додаток Slack:

  1. Перейдіть за адресою https://api.slack.com/slack-apps.
  2. Натисніть "Create a Slack App".
  3. Дайте вашому додатку ім'я та виберіть правильний робочий простір. Після створення додатку перейдіть до розділу "Incoming Webhooks" та додайте новий вебхук до робочого простору.
  4. Скопіюйте створене посилання, поверніться до UA-Pro ERP та використовуйте його для створення нової URL-адреси вебхука Slack у розділі Інтеграції > Slack Webhook URL.
  5. Виберіть Slack та ваш канал Slack у полях каналу та каналу Slack у вашому сповіщенні.

2.2 Формат повідомлення

На відміну від електронних листів, Slack не дозволяє HTML-форматування.

Замість цього ви можете використовувати форматування markdown: Документація Slack

Приклад: {% raw %} Замовлення прострочено

Транзакція {{ doc.name }} перевищила термін оплати. Будь ласка, вжийте необхідних заходів.

{% if comments %}
Останній коментар: {{ comments[-1].comment }} від {{ comments[-1].by }}
{% endif %}

*Деталі*

• Клієнт: {{ doc.customer }}
• Сума: {{ doc.grand_total }}
{% endraw %}

  1. Системні сповіщення

У Версії 12 ми ввели системні сповіщення для Призначень, згадок, документів, якими поділилися, та Балів енергії. Ці сповіщення відображаються у випадаючому списку сповіщень у правому верхньому куті панелі навігації.

У Версії 13 ми ввели додатковий канал для надсилання сповіщень - Системні сповіщення:

Вибір цього каналу призведе до надсилання системного сповіщення при спрацьовуванні сповіщення замість електронного листа або сповіщення у Slack.

Натискання на сповіщення перенаправляє до документа Журнал сповіщень, який містить налаштовану тему, повідомлення, а також доданий файл, якщо встановлено "Додати друк":

Якщо потрібні як сповіщення по Email/Slack, так і системні сповіщення, основним каналом можна встановити Email або Slack, а цю опцію можна позначити:

  1. WhatsApp

У Версії 13 ми ввели додатковий канал для надсилання сповіщень - WhatsApp:

Якщо ви віддаєте перевагу надсиланню сповіщень на номер WhatsApp, ви також можете вибрати опцію "WhatsApp" у параметрах каналу та обрати відповідний номер Twilio. Номери Twilio можна додати до налаштувань Twilio у Frappe. Повідомлення WhatsApp можна надсилати лише на номери, які містять коди країн.

4.1 Налаштування Twilio

Щоб налаштувати параметри Twilio, спочатку потрібно отримати облікові дані Twilio з налаштувань облікового запису вашого облікового запису Twilio. Ви можете додавати лише ті номери телефонів, які були активовані у вашому обліковому записі Twilio з доступом до WhatsApp.

4.2 Формат повідомлення

WhatsApp дозволяє своїм користувачам надсилати лише ті шаблони повідомлень, які були попередньо схвалені ними для ваших клієнтів. Невиконання цього може призвести до обмежень у вашому обліковому записі Twilio.

  1. SMS

У Версії 13 ми ввели додатковий канал для надсилання сповіщень - SMS:

Щоб використовувати цей канал, вам потрібно завершити конфігурацію Налаштувань SMS.

7. Одноразові нагадування

Примітка: Наразі ця функція доступна лише у нічній версії.

Оскільки налаштування сповіщень є досить складним процесом, Frappe Framework також надає спосіб налаштувати одноразові нагадування на документах. Прикладом такого сповіщення може бути "Нагадати мені про подальші дії щодо цього потенційного клієнта через 4 години".

Щоб налаштувати одноразове нагадування на документі:

  1. Відкрийте документ, на якому ви хочете встановити нагадування.
  2. Натисніть на меню (три крапки) > "Нагадати мені".
  3. Виберіть час та додайте опис для себе та натисніть "Створити".
  4. Система надішле вам системне сповіщення приблизно в налаштований час із описом нагадування як темою.