Подключение Яндекс Маркета

EasyChat собирает чаты покупателей, вопросы о товарах и отзывы Яндекс Маркета в общей очереди операторов. Каждый сценарий сохраняет собственные статусы и допустимые действия: вопрос или отзыв не превращается в обычное сообщение.

Что Подготовить

• Действующий кабинет продавца Яндекс Маркета.
• Отдельный Api-Key Partner API для нужного бизнеса.
• Право Общение с покупателями (COMMUNICATION). Ключ только для чтения позволит получать обращения, но не позволит отвечать.
• Публичный HTTPS-адрес установленного EasyChat.
• Регулярно работающий основной cron EasyChat.

Выдавайте ключу только необходимые права. Не присылайте Api-Key в поддержку, не размещайте его в скриншотах и не вставляйте в callback URL.

Подключить Кабинет

1. Откройте EasyChat → Интеграции → Яндекс Маркет.
2. Вставьте Api-Key.
3. Нажмите Проверить и подключить.
4. Убедитесь, что EasyChat определил правильный business ID и показал кабинет как подключённый.
5. Скопируйте callback URL из карточки кабинета.
6. В кабинете Яндекс Маркета откройте настройки уведомлений Partner API, укажите этот URL и включите события чатов, вопросов и отзывов.

EasyChat проверяет scope до сохранения, определяет business ID через Partner API и хранит ключ зашифрованным на сервере установки. Callback URL можно скопировать одной кнопкой; секреты в HTML и URL не выводятся.

Что Доступно Оператору

• Чаты покупателей: текст, поддерживаемые изображения и файлы, история и ответы из web или Android.
• Новый чат: запуск по ID заказа (ORDER) или возврата (RETURN), если Маркет разрешает этот сценарий.
• Вопросы о товарах: создать ответ или комментарий, изменить либо удалить собственную доступную реплику.
• Отзывы: ответить, продолжить ветку, изменить или удалить собственный комментарий и отметить отзыв как не требующий ответа, когда это разрешено.

Специальные действия показываются только для подходящего состояния обращения и выполняются после явного действия оператора. Быстрый повторный клик не создаёт второй запрос.

Как Доставляются События

Callback Яндекс Маркета — это только адресный сигнал с идентификатором изменившейся сущности. EasyChat:

1. принимает запрос только от опубликованных Яндексом сетей;
2. проверяет, что business ID относится к подключённому кабинету;
3. сохраняет безопасную подсказку до ответа 200 OK;
4. загружает точный чат, сообщение, вопрос, ответ, отзыв или комментарий через Partner API;
5. дедуплицирует результат и только после успешной обработки удаляет подсказку.

Периодическая сверка остаётся включённой всегда. Она восстанавливает событие, если callback потерялся, повторился или пришёл не по порядку. Маркет не отправляет отдельное уведомление для стикера, поэтому cron — обязательная часть интеграции, а не аварийный режим.

AI-Автоответ

Переключатель Автоответ ИИ в чатах покупателей находится в карточке кабинета и по умолчанию выключен. После явного включения ИИ может отвечать только в обычном личном чате покупателя с учётом истории диалога.

Вопросы, отзывы, служебные события, первичный импорт истории и callback-сигналы никогда не запускают автоматический ответ и не расходуют AI-токены. Для вопросов и отзывов оператор сначала проверяет подготовленный текст и сам подтверждает действие.

Проверить В Обе Стороны

1. Отправьте покупательское сообщение в Маркете.
2. Убедитесь, что диалог появился с официальной меткой Яндекс Маркет.
3. Ответьте из web-панели и проверьте доставку в кабинете Маркета.
4. Откройте тот же диалог в Android и отправьте второй ответ.
5. Проверьте изображение или файл допустимого формата.
6. Создайте тестовый вопрос и отзыв, затем выполните доступное действие после проверки текста.
7. Используйте Новый → Яндекс Маркет, выберите заказ или возврат и укажите настоящий ID из этого кабинета.
8. Проверьте последнюю успешную синхронизацию после очередного запуска cron.

Частые Ситуации

• Ключ не подключается. Проверьте право COMMUNICATION и принадлежность ключа нужному кабинету.
• Входящие приходят только после cron. Проверьте HTTPS, callback URL и выбранные события в кабинете Маркета.
• Callback отклоняется за reverse proxy. Настройте web-сервер так, чтобы PHP видел реальный адрес подключения в REMOTE_ADDR. EasyChat намеренно не доверяет произвольным X-Forwarded-For.
• Ответ недоступен. Ключ может быть только для чтения либо состояние обращения не разрешает выбранное действие.
• Новый чат не открывается. Проверьте тип контекста, числовой ID и его принадлежность текущему бизнесу.
• Сообщение отправлено, но статус обновился не сразу. Маркет может вернуть успешный ответ без ID сообщения; EasyChat сверит точное эхо в истории и не будет выдумывать внешний идентификатор.

Мини-Чеклист

• Api-Key имеет минимально достаточное право COMMUNICATION.
• EasyChat определил правильный business ID.
• Callback URL сохранён в кабинете Маркета.
• Основной cron выполняется регулярно.
• Чат, вопрос, отзыв и вложение проверены.
• Ответ проверен в web и Android.
• AI-автоответ остаётся выключенным до отдельной проверки правил и затрат.