Уведомления о финансах: подписка и баланс

Откройте вкладку «Уведомления»

Левое меню, «Подписка». Внизу карточки «Счёт и подписка» есть строка про уведомления и ссылка «Настроить уведомления». Она открывает нужную вкладку сразу.

Прямой адрес тоже работает, это `/pages/subscription?tab=alerts`.

Выберите, о чём предупреждать

Два переключателя, оба включены по умолчанию. Под первым видом FlowZap показывает дату и сумму ближайшего продления и сколько денег не хватает прямо сейчас.

Выключить оба вида сразу нельзя. Тогда гаснет общий выключатель, и письма с сообщениями перестают приходить.

Задайте порог низкого баланса

Порог считается двумя способами. «В процентах» он берётся от последнего пополнения, а если пополнений ещё не было, то от суммы ближайшего продления. Доступно от 5 до 50 процентов, по умолчанию 10. «Суммой» вы задаёте число в валюте компании, от 500 до 10 000 000, по умолчанию 5 000.

Под ползунком FlowZap сразу пишет, сколько это в деньгах и какой у вас баланс. Порог срабатывает один раз и взводится заново, когда вы пополните счёт или баланс поднимется до 1,2 порога.

Решите, приходить ли уведомлениям ночью

«Не беспокоить ночью» включено по умолчанию. С 21:00 до 08:00 по часовому поясу компании напоминания и предупреждения ждут утра.

Приостановка услуги, продление подписки и неудачный переход с пробного периода приходят сразу, в любое время.

Добавьте получателей

Карточка «Куда присылать» держит три способа. До трёх адресов почты, до двух номеров WhatsApp и один адрес для вебхука. Как добавить каждый, разобрано ниже.

Отправляем только на подтверждённые адреса и номера. Способ нельзя включить, пока в нём нет ни одного подтверждённого получателя, галка просто не нажимается.

Включите отправку и сохраните

Отметьте способы, которыми хотите получать сообщения, и переведите общий выключатель в положение «Включены». Нажмите «Сохранить».

Пока выключатель выключен, получатели и порог остаются на месте, а письма и сообщения не приходят. Сразу после сохранения нажмите «Отправить тестовое» и выберите получателя. На каждый адрес и номер тестовое уходит один раз, зато проходит весь путь доставки и показывает, как письмо или сообщение выглядит у вас.

Введите адрес и запросите код

Нажмите «Добавить адрес», впишите почту и нажмите «Получить код». Если e-mail компании уже подтверждён в профиле, рядом появится кнопка «Использовать e-mail компании», она переносит адрес одним кликом и без кода.

Введите код из письма

Письмо приходит от FlowZap в течение минуты, в нём шесть цифр. Впишите их в окно и нажмите «Подтвердить». Код живёт 10 минут, попыток восемь, после этого адрес отдыхает полчаса.

Письма нет дольше двух минут, стоит заглянуть в спам и проверить, нет ли опечатки в адресе. Кнопка «Изменить адрес» в этом же окне правит адрес, не закрывая его.

Убедитесь, что адрес подтверждён

У готового адреса стоит зелёный чип «Подтверждён» с датой. Только такие адреса получают письма, адрес в состоянии «Ждёт код» пока не получает ничего.

Введите номер и запросите код

Нажмите «Добавить номер», выберите страну и наберите номер. Кнопка «Получить код» станет активной, когда номер окажется настоящим. Номеров может быть два, это предел.

Введите код из WhatsApp

Код приходит сообщением с номера FlowZap, у него есть кнопка «Копировать код». Впишите шесть цифр и нажмите «Подтвердить». Повторный код в WhatsApp запрашивается через 5 минут, дальше пауза растёт до часа.

Коды в WhatsApp платные, поэтому браузер перед отправкой решает небольшую задачу, а на сами коды стоят лимиты. Если код так и не пришёл, а лимит закончился, добавьте вместо номера почту.

Вставьте адрес и нажмите «Проверить»

Адрес бывает только `https`, порт 443 или 8443, хост публичный. Локальные и внутренние адреса вроде 127.0.0.1 или 192.168.x.x FlowZap не примет. Кнопка «Проверить» отправляет пробный вызов с событием `verification`, ваш сервер должен ответить за 10 секунд.

Рядом с названием способа есть значок с буквой i. Он открывает памятку с заголовками, полным примером тела и списком событий, её можно скопировать целиком и отдать разработчику.

Сохраните ключ

После успешной пробы FlowZap создаёт ключ вида `fz_k_…` и показывает его один раз. Скопируйте ключ сразу, потом в кабинете останутся только последние символы.

Проверьте подпись на своей стороне

Каждый вызов несёт заголовки с ключом, подписью, именем события и номером доставки. Подпись считается от сырых байтов тела, а не от разобранного и заново собранного JSON, иначе она не сойдётся.

Если ваш сервер не ответил 200, FlowZap повторит вызов через 1 и через 10 минут с тем же номером доставки, так что защитите обработчик от повторов. После 10 неудачных вызовов подряд адрес отключается, галка способа снимается, а владельцу приходит строка в колокольчик. Кнопка «Проверить снова» возвращает адрес в строй.

const crypto = require('node:crypto')

// body - сырые байты запроса, не разобранный и заново собранный JSON
function verify(body, headers, key) {
  const expected = 'sha256=' + crypto.createHmac('sha256', key).update(body).digest('hex')
  const got = headers['x-flowzap-signature'] || ''

  return got.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(got), Buffer.from(expected))
}