Бот VK Max: статусы заказа и push-уведомления клиентам

Max-бот пишет статус заказа: принят → собран → у курьера — без звонка «где посылка».

Стек FastAPI, Python, VK Max, webhooks

Клиент — интернет-магазин товаров для дома (B2C, ~2 000 заказов в месяц). Клиенты звонили «где заказ» — до 30% обращений в поддержку. SMS-уведомления дороги и игнорируются; email open rate < 15%. Аудитория активна во VK Max.

Задача: Max-бот — клиент подписывается по номеру заказа или телефону, получает push при смене статуса: принят → собран → передан курьеру → доставлен. Кнопка «Связаться с поддержкой» при проблеме.

  • Max Bot API: webhook, deep-link «Открыть статус заказа» с сайта и из письма;
  • привязка заказа: номер + последние 4 цифры телефона (без лишнего PII);
  • интеграция с OMS/WMS: события status_changed → шаблонное сообщение в Max;
  • 6 статусов + ETA доставки из API логистики;
  • opt-in при первом входе; отписка одной командой;
  • админка: шаблоны сообщений, лог доставок, retry при ошибке API Max;
  • rate limit и идемпотентность webhook OMS.

Стек: Python, FastAPI, Max Bot API, REST OMS, PostgreSQL, Redis, Docker. Приёмка: полный цикл заказа на staging, 0 потерянных событий.

Итог: обращений «где заказ» −45%; delivery notification read rate ~80%. NDA: магазин не публикуется.