Если у магазина есть собственная интеграция с Яндекс Маркетом, передайте интегратору задачу: получать сообщения о новом отзыве и новом комментарии, находить нужное обсуждение и передавать его ответственному. Успешное подключение само по себе ещё не означает, что менеджер увидит обращение.
Это гайд для владельца магазина и руководителя поддержки, которые заказывают доработку своей системы. Ниже — требования к результату и проверке. Возможности API Маркета не означают, что такой способ получения событий уже реализован в Астре.
Что подтверждено документацией Маркета
Официальный перечень API-уведомлений включает новый отзыв о товаре и новый комментарий к отзыву. Пошаговая инструкция по работе с отзывами отдельно подтверждает оба сценария. Это действующая возможность интеграции, а не анонс с будущей датой запуска. Дату её появления эти страницы не устанавливают.
По документации подключения, оба типа уведомлений доступны на уровне кабинета. Настроить их для отдельного магазина по той же схеме нельзя. Для настройки на уровне кабинета нужна роль владельца или менеджера кабинета. Источник: https://yandex.ru/dev/market/partner-api/doc/ru/push-notifications/
По справочнику получения уведомлений, сообщение о новом отзыве отправляется после модерации и публикации отзыва. Поэтому отсутствие сообщения сразу после отправки покупателем ещё не доказывает поломку. Источник: https://yandex.ru/dev/market/partner-api/doc/ru/push-notifications/reference/sendNotification
Что подготовить до передачи задания
- Укажите кабинет Маркета, для которого нужна доработка, и человека с правом подключить уведомления. Не пересылайте доступы в общий чат.
- Опишите текущую систему: где менеджеры разбирают отзывы и куда должна попадать новая задача — например, в вашу CRM.
- Назначьте основного ответственного и замену. Согласуйте, кто разбирает новый отзыв, а кто — продолжение уже открытого обсуждения.
- Попросите интегратора оценить работу и предложить дату проверки. Дату запуска согласуйте после оценки, без обещания фиксированного срока заранее.
Не начинайте с выбора канала уведомлений. Сначала договоритесь о результате: сотрудник должен понимать, какой товар обсуждают, что именно появилось и куда перейти для ответа. Сообщение «пришёл новый отзыв» без контекста только переносит ручной поиск в другой канал.
Что включить в задание интегратору
«Подключите для нашего кабинета Яндекс Маркета уведомления о новых отзывах о товарах и новых комментариях к отзывам. Для каждого события найдите соответствующее обсуждение и передайте его ответственному в согласованную систему. Различайте новый отзыв и продолжение переписки. Покажите получение события, появление задачи и поведение при повторной доставке или сбое. Передайте инструкцию по контролю работы.»
В кабинете продавца подключение находится в настройках, в разделе «API и модули», на вкладке «API-уведомления». Адрес приёма сообщений должен подготовить интегратор. По требованиям Маркета соединение должно быть защищённым, а подлинность входящих сообщений нужно проверять. Детали реализации оставьте специалисту; при приёмке попросите подтвердить выполнение этих требований.
| Событие | Что поручить | Что должен увидеть сотрудник |
|---|---|---|
| Новый отзыв | Получить сведения об отзыве и связать их с товаром | Понятную задачу для разбора отзыва |
| Новый комментарий | Найти отзыв и соответствующую ветку обсуждения | Продолжение переписки с контекстом |
| Повторная доставка | Распознать уже обработанное событие | Существующую задачу без лишней копии |
| Сбой передачи ответственному | Сохранить сведения о недоставленной задаче и сообщить о проблеме | Понятный статус и способ восстановить работу |
Состав карточки задачи — ваше требование к собственной системе. Укажите кабинет, товар, вид события, текст или доступный контекст, ответственного и способ открыть обсуждение. Интегратор должен проверить, какие сведения приходят в уведомлении, а какие надо получить отдельно. Не требуйте, чтобы всё содержимое отзыва обязательно находилось в самом сообщении о событии.
Инструкция Маркета разделяет уведомление и получение подробностей: отзывы и комментарии запрашиваются отдельно. Поэтому в оценку работ включите не только подключение событий, но и получение нужного содержания. Источник: https://yandex.ru/dev/market/partner-api/doc/ru/step-by-step/goods-feedback
Как принять работу: от события до сотрудника
Попросите показать весь путь на реальных доступных событиях вашего кабинета. Не создавайте фиктивные отзывы ради проверки. Проверочное сообщение Маркета подтверждает подключение, но не заменяет проверку отзыва и комментария. Пока подходящее событие не появилось, отметьте соответствующий сценарий как непроверенный.
- Проверка подключения: в кабинете видно активное уведомление, интегратор показывает успешный приём проверочного сообщения.
- Проверка нового отзыва: опубликованный отзыв находится в системе магазина, относится к нужному кабинету и товару, назначен ответственному.
- Проверка комментария: сообщение ведёт в нужное обсуждение, сотрудник видит контекст и понимает, требуется ли реакция.
- Проверка повтора: повторная обработка того же события не создаёт лишнюю задачу. Это проверяют на сохранённом примере без повторного обращения к покупателю.
- Проверка сбоя: интегратор демонстрирует безопасную имитацию недоступности канала передачи, обнаружение проблемы и восстановление задачи.
Условия зачёта запишите до проверки. Для каждого сценария сохраните пример обсуждения, результат и ответственного за исправление. Если уведомление принято системой, но задача не появилась у сотрудника, сценарий ещё не пройден. Отдельно проверьте, что продолжение переписки не теряется среди новых отзывов.
Какие сроки согласовать и кто следит за сбоями
По инструкции Маркета, после подключения уведомления начинают приходить в течение 2 минут. Это срок включения, а не обещание доставки любого отзыва менеджеру за такое время. Источник: https://yandex.ru/dev/market/partner-api/doc/ru/push-notifications/
Внутренний срок реакции продавец задаёт сам: с учётом графика поддержки и нагрузки. Отдельно согласуйте с интегратором допустимую задержку передачи события, а с руководителем поддержки — срок разбора задачи. Не выдавайте эти договорённости за обязательные нормативы Маркета.
До запуска договоритесь, кто замечает остановку потока и кому сообщает. Отсутствие новых уведомлений может означать как отсутствие событий, так и проблему. Попросите предусмотреть контроль работоспособности и сверку с кабинетом. Частоту сверки определите вместе с интегратором по объёму обращений и риску пропуска.
При сбое менеджер должен знать резервный порядок: где проверить отзывы вручную, кому сообщить о проблеме и как отметить уже обработанные обсуждения. После восстановления нужно сверить пропущенный период, чтобы покупатели не остались без внимания, а сотрудники не отвечали повторно.
Что сделать сейчас
Отправьте интегратору формулировку задания и таблицу требований. Запросите оценку, дату демонстрации и список доступов. Принимайте работу после проверки обоих событий и передачи задач ответственному. Сохраните краткую инструкцию: кто обслуживает подключение, кто разбирает обращения и как действовать при сбое.
Выберите инструкции по работе с отзывами и передайте подходящие рекомендации своей команде.
