Работа с маркетплейсами
Работа в Salebot с известными маркетплейсами OZON и Wilberries
OZON
Как собрать отзывы о товаре с OZON
Функция ozon_goods_feedbacks(goods_id, name) позволяет собрать последние 20 отзывов с карточки товара маркетплейса ozon по артикулу товара goods_id - обязательный параметр, артикул товара name - необязательный параметр, позволяет искать по имени пользователя, указанный при регистрации на маркетплейсе.
Пример:
Рассмотрим внимательно ссылку на товар:
https://www.ozon.ru/product/jacobs-monarch-kofe-v-zernah-800-g-138218835/, последние цифры это необходимый нам артикул.
name = "Виктор" oz = ozon_goods_feedbacks(138218835, name)
В результате выполнения функции придет ответ в виде массива со словарями: [{"author":"Юлия Л.","comment":"","positive":"","negative":"","videos":[],"photos":[],"score":4},{"author":"Лилия К.","comment":"","positive":"","negative":"","videos":[],"photos":[],"score":5},{"author":"Кричевская Елена","comment":"мой любимый кофе. ","positive":"","negative":"","videos":[],"photos":[],"score":5},{"author":"Пользователь предпочёл скрыть свои данные","comment":"","positive":"","negative":"","videos":[],"photos":[],"score":5},{"author":"Ульяна Ш.","comment":"","positive":"","negative":"","videos":[],"photos":[],"score":5}]
Wildberries
Собрать отзывы Wildberries
Функция wildberries_goods_feedbacks(wildberries_api_key, is_answered, nm_id, take, skip, date_from, date_to, full_data) позволяет собрать последние отзывы с карточки отзывов товара маркетплейса Wildberries по артикулу
Обязательные параметры функции:
wildberries_api_key - обязательный, API ключ с Wildberries
Дополнительные необязательные параметры:
isAnswered - Обработанные отзывы (True) или необработанные отзывы(False)
nm_id - Артикул товара Wildberries можно получить из ссылки на товар или скопировать в кабинете WB
take - Количество отзывов (max. 5 000), по умолчанию 20
skip - Количество отзывов для пропуска (max. 199990), по умолчанию 0
date_from - Дата начала периода в формате дд.мм.гггг (пример: 22.10.2022)
date_to - Дата конца периода в формате дд.мм.гггг (пример: 23.10.2022)
full_data - вернуть полный ответ от Wildberries. Чтобы получить полный ответ от Wildberries передайте значение для данного параметра 1
Пример 1:
Чтобы получить последние 20 неотвеченных отзывов достаточно в функции передать только обязательный параметр wildberries_api_key
Пример для копирования:
Пример 2:
Получить отвеченные отзывы за 25 мая 2023 года:
В результате выполнения функции в переменную (название переменной -на ваше усмотрение, кроме встроенных и служебных переменных) будет записан массив со словарями ответ похожий на этот:
request_WB = [{"id":"1h-2RikBC75Dkq7NjfNN","nmId": 123456,"author":"Татьяна","content":"Отличный товар"},{"id":"wTy2RokBXuXi8PE1d4kE","nmId": 123456,"author":"Вася","content":"Хороший товар"}, {"id":"s5W0RokBl47N78Z1D758","nmId": 123456, "author":"Мира","content":"Все ок."}]
После этого можно получить идентификатор отзыва из значения переменной.
Для примера получим значение feedback_id первого отзыва. В Калькуляторе блока укажите:
Подробнее как получать значение элементов из массива описано в этой статье:
Получение значение из словаря здесь:
Пример настройки схемы:
Пользователь запускает бота, в ответ на сообщение бота присылает номер артикула, например 68952198.
В примере с помощью стрелки со сбором данных сохраняем значение в переменную nm_id и в следующем блоке указываем следующий запрос:
Отправить ответ на отзыв Wildberries
С помощью функции wildberries_answer_to_feedback(wildberries_api_key, feedback_id, text) можно отправить ответ на отзыв Wildberries.
Для функции wildberries_answer_to_feedback(wildberries_api_key, feedback_id, text) ВСЕ параметры являются обязательными:
wildberries_api_key - обязательный, API ключ с Wildberries
feedback_id - идентификатор отзыва можно получить из массива словарей, полученного при выполнении функции wildberries_goods_feedbacks()
text - текст ответа на отзыв
Список вопросов
С помощью функции можно получить список вопросов по заданным параметрам с пагинацией и сортировкой. За один запрос можно получить 10 000 вопросов, максимум.
Функция wildberries_questions(api_key, is_answered, take, skip, order, date_from, date_to, nm_id)
Параметры функции:
pi_key - обязательный параметр, API ключ с Wildberries
is_answered — true (Отвеченные вопросы) или false (неотвеченные вопросы)
take - Количество запрашиваемых вопросов, при этом максимально допустимое значение для параметра - 10 000, а сумма значений параметров take и skip не должна превышать 10 000)
skip - Количество вопросов для пропуска, при этом максимально допустимое значение для параметра - 10 000, а сумма значений параметров take и skip не должна превышать 10 000)
order - Сортировка вопросов по дате, значение параметра может быть либо dateAsc (по возрастанию), либо dateDesc (по убыванию)
date_from - Дата начала периода
date_to - Дата конца периода
nm_id — артикул Wildberries
Работа с вопросами
Просмотреть вопрос: функция wildberries_question_mark_viewed(api_key, id, was_viewed)
Параметры:
api_key - обязательный, API ключ с Wildberries
id — обязательный, id вопроса
was_viewed — может иметь следующие значения: true (просмотрен), false (не просмотрен)
Отклонить вопрос: функция wildberries_answer_question(api_key, id, text, state)
Параметры:
api_key - обязательный, API ключ с Wildberries
id — обязательный, id вопроса
text — обязательный, текст ответа
state — чтобы отклонить вопрос, значение параметра должно быть "none"
Ответить на вопрос или отредактировать ответ: функция wildberries_answer_question(api_key, id, text, state)
Отредактировать ответ на вопрос можно в течение 2 месяцев (60 дней), после предоставления ответа и только 1 раз.
Параметры:
api_key - обязательный, API ключ с Wildberries
id — обязательный, id вопроса
text — обязательный, текст ответа
state — чтобы ответить на вопрос или отредактировать ответ, значение параметра должно быть "wbRu"
Last updated
