VK Push: агент для уведомлений приложения

Push-уведомления в приложениях ВКонтакте — короткий канал, который приводит человека обратно в приложение или в диалог. Агент следит, чтобы уведомления уходили по делу и не превращались в поток, который выключают.

Агент — программа, которая выполняет работу целиком. Ему не надо объяснять, что такое пуш: он смотрит на событие и сам решает, нужно ли беспокоить человека.

Три признака. Работает в ваших сервисах. Доводит дело до результата — до отправленного уведомления и понятной статистики. Работает без вас: по событию и по списку получателей.

Чат-бот ответит, что уведомление отправить можно. Агент отправит его и покажет, кому оно ушло, а кому нет.

Коннектор описывает подключение: где взять доступ, какие данные видны, как убедиться, что канал живой. Для уведомлений доступ выдаётся приложению ВКонтакте — оно получает идентификатор и ключ, а агент действует от его имени.

Это не плагин и не правка кода приложения. Пароль пользователя коннектор не хранит и переписку не читает.

Отправка идёт методом notifications.sendMessage. У него есть список получателей user_ids, текст message и необязательный fragment — короткая часть сообщения для превью. Параметр random_id защищает от дубля при повторной попытке, а sending_mode задаёт режим доставки: значение immediately отправляет сразу, второй режим откладывает отправку.

Служебные методы закрывают учёт: notifications.get возвращает уведомления о реакциях, notifications.markAsViewed сбрасывает счётчик новых. Идентификатор сообщества задаёт group_id — от чьего имени пойдёт уведомление. Схема методов сверена по официальной схеме VK API.

### Входящая корреспонденция: регистрация и резолюция

Обращение в приложении приходит не письмом, а событием, и без разметки теряется. Агент регистрирует его в журнале, связывает с человеком и готовит черновик резолюции. Если событие срочное, он собирает короткое уведомление с фрагментом текста для превью.

### Заявки из почты, форм и мессенджеров

Заявки приходят из разных каналов, а уходят в один — пуш. Агент приводит их к общему набору полей, отсекает повторы по random_id и по совпадению получателя, затем собирает отправку списком user_ids. Что не прошло проверку, остаётся на уточнение с причиной.

### Сводки по обращениям: день и месяц

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

Текст уведомления утверждает сотрудник, он же решает, кого не беспокоить в нерабочие часы. Жалобу на навязчивость разбирает человек.

Ключ выдаётся приложению ВКонтакте: сначала оно создаётся и получает идентификатор, затем в его настройках оформляется доступ к уведомлениям. Агент работает с этим ключом и с group_id сообщества. Проверка связи — отправка уведомления самому себе.

Не пишет людям, которые отключили уведомления. Не обходит лимиты платформы и не подменяет текст после утверждения.

Что такое агент, если коротко? Программа, которая доводит дело до результата: смотрит на событие, собирает уведомление и отправляет его, а не рассказывает, как настроить пуш.

Что такое коннектор? Описание подключения: где взять ключ приложения, что видно через него и как проверить связь. Пароль человека агенту не нужен.

Можно ли отложить уведомление? Да, режим доставки задаётся в запросе; агент выбирает его по правилу, которое утвердил человек.