Работа с маркетплейсами

Работа в 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

Пример для копирования:

request_WB1 = wildberries_goods_feedbacks('wildberries_api_key')

Пример 2:

Получить отвеченные отзывы за 25 мая 2023 года:

wildberries_api_key = "h***************************************kl"
/*замените значение wildberries_api_key на апи ключ из WB*/
request_WB = wildberries_goods_feedbacks(wildberries_api_key, True, nm_id, 20, 0, '25.05.2022', '26.05.2022')

В результате выполнения функции в переменную (название переменной -на ваше усмотрение, кроме встроенных и служебных переменных) будет записан массив со словарями ответ похожий на этот:

request_WB = [{"id":"1h-2RikBC75Dkq7NjfNN","nmId": 123456,"author":"Татьяна","content":"Отличный товар"},{"id":"wTy2RokBXuXi8PE1d4kE","nmId": 123456,"author":"Вася","content":"Хороший товар"}, {"id":"s5W0RokBl47N78Z1D758","nmId": 123456, "author":"Мира","content":"Все ок."}]

После этого можно получить идентификатор отзыва из значения переменной.

Для примера получим значение feedback_id первого отзыва. В Калькуляторе блока укажите:

/* сохраним идентикатор отзыва,который указан первым в массиве request_WB*/
feedback_id = request_WB['0']['id']

Подробнее как получать значение элементов из массива описано в этой статье:

Получение значение из словаря здесь:

Пример настройки схемы:

Пользователь запускает бота, в ответ на сообщение бота присылает номер артикула, например 68952198.

В примере с помощью стрелки со сбором данных сохраняем значение в переменную nm_id и в следующем блоке указываем следующий запрос:

wildberries_api_key = "h***************************************kl"
/*замените значение wildberries_api_key на апи ключ из WB*/
request_WB = wildberries_goods_feedbacks(wildberries_api_key, True, nm_id, 20, 0, '25.05.2022', '26.05.2022')

Отправить ответ на отзыв 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