Как выгрузить отзывы и рейтинг в собственную CRM-систему?

Как выгрузить отзывы и рейтинг в собственную CRM-систему?

Если вы хотите выгружать отзывы и рейтинги в собственную CRM-систему, то вы можете подключить API Pinbox.

1 Запросите у службы поддержки Pinbox доступ к API.

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

3 Интегрируйте токен в собственную CRM-систему и данные отобразятся у вас.

API отзывов — запрос данных

Для получения данных используйте ссылку: https://pinbox.ru/api2/reviews/?limit=10&offset=0&token=< ВАШ_ТОКЕН >

Для оптимизации рекомендуем загружать только последние отзывы по limit=50 и offset=0.

limit — количество отзывов в запросе (максимум 100), не обязательный параметр

offset — смещение для постраничной выгрузки, не обязательный параметр

token — индивидуальный ключ клиента

from — дата отзывов начальная в формате (Y-m-d), не обязательный параметр

to — дата отзывов конечная в формате (Y-m-d), не обязательный параметр

sort — сортировка даты в обратном или прямом порядке (два значения 0 или 1 ), не обязательный параметр

API отзывов — ответ json

region — город или иной населенный пункт

address — адрес филиала

revID — номер отзыва в системе Pinbox

sourceID — номер геосервиса в системе Pinbox

cardID — номер филиала в системе Pinbox

xmlID — номер филиала в системе Клиента (передается через API XML филиалов)

review — сам отзыв

author — автор отзыва

rating — рейтинг отзыва на геосервисе

date — дата отзыва в формате Y-m-d

answ — ответ на отзыв

claim — жалоба на отзыв

tag — тег, которым был помечен отзыв

del — показывает удален отзыв или нет

url — ссылка на отзыв на геосервисе

API рейтингов — запрос данных

Для получения данных используйте ссылку: https://pinbox.ru/api2/rating/?period=last&offset=0&token=< ВАШ_ТОКЕН >

При указании xmlID или card, выгрузка рейтинга произойдет по данному филиалу, в ином случае по всем филиалам.

xmlID — номер филиала в системе Клиента (передается через API XML филиалов), не обязательный параметр

card — номер филиала в системе Pinbox, не обязательный параметр

token — индивидуальный ключ клиента

period — данные по указанному периоду (last — последний месяц или в формате Y-m, например 2023-12)

API рейтингов — ответ json

date — год и месяц рейтингов

card-region — город или иной населенный пункт

rating — рейтинг филиала на геосервисе

quantity — количество оценок на геосервисе

sourceID — номер геосервиса в системе Pinbox

source — название геосервиса

Отправка ответов и жалоб из вашей системы в Pinbox

Для ответов и жалоб на отзывы из вашей системы обработки отзывов реализован постоянно открытый порт на стороне Pinbox, постоянно ожидающий такой вызов. После получения вызова, происходит проверка на целостность данных, сохранение данных в Pinbox и отправка данных на геосервис. Для этого достаточно отправить данные по указанной ссылке https://pinbox.ru/api2/whreviews/?token=ТОКЕН.

Параметры запроса

Формат — multipart/form-data или application/json

revID — номер отзыва, полученный ранее по API

answ — текст ответа на отзыв

answU — номер пользователя отвечающего на отзыв (по классификации Pinbox) НЕ обязательный параметр

claim — текст жалобы на отзыв

claimU — номер пользователя отправляющий жалобу на отзыв (по классификации Pinbox) НЕ обязательный параметр

Ответ сервера

revID is empty — отсутствует номер отзыва

answ is empty — отсутствует текст отзыва, если не было жалобы

review not found — отзыв не найден по указанному ID

review send — ответ на отзыв принят и отправлен на геосервис

API филиалов

Для обмена данными филиалов используется формат XML, подробнее на странице https://pinbox.ru/support/xml-zagruzka/

API прайсов

Для обмена данными товаров и услуг используется формат XML, подробнее на странице https://pinbox.ru/support/xml-zagruzka-praysov/