Как отвечать на отзывы

Ответ, отправленный через Rewio, появляется под отзывом на самой площадке, от лица вашей организации.

curl -X PUT https://api.rewio.ru/v3/reviews/143046/reply \
  -H "X-API-Key: hrev_ВАШ_FULL_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"text": "Спасибо за отзыв! Рады, что всё понравилось."}'
# -> 202 { "text": "Спасибо за отзыв! …", "status": null, … }

Что нужно до первого ответа

Четыре условия, все обязательные:

Почему закрепление отдельное условие: ответ появляется под отзывом от имени организации, а не от имени Rewio. Добавить чужую карточку в свои объекты может кто угодно – это штатная возможность, по ней работает аналитика конкурентов. Поэтому право отвечать мы подтверждаем отдельно от того, что объект заведён.

Клиентам, которые отвечают своей учётной записью площадки, закрепление не нужно: площадка пустит их ровно туда, где они вправе, и подтверждать это второй раз нечем.

Где это работает

Сейчас на четырёх площадках:

В 2ГИС площадка не разрешает переписывать опубликованный ответ: попытка вернёт 409 с кодом reply_edit_not_supported. Чтобы поменять текст, удалите ответ и опубликуйте заново.

На ПроДокторов ответ публикует клиника, и площадка не даёт ни переписать, ни удалить опубликованный ответ (reply_edit_not_supported / reply_delete_not_supported). Ответ проходит модерацию площадки, поэтому появляется под отзывом не мгновенно.

На какие отзывы можно отвечать

Площадки показывают в своей ленте не только собственные отзывы, но и отзывы других площадок: 2ГИС – отзывы Booking, Т-Банка, Flamp; Google – отзывы Tripadvisor. Ответить на такой отзыв через кабинет площадки, которая его лишь отображает, нельзя.

Источник самого отзыва виден в поле provider (слаг в нижнем регистре) у каждого отзыва в GET /reviews. Ответ пройдёт, только если provider совпадает с source_slug этого же отзыва (слаг площадки, с которой он собран, — отдаётся рядом с source_id). У нативного отзыва так и есть. На отзыв, чей provider иной (tbank, booking, tripadvisor, …), PUT сразу вернёт 409 с кодом reply_not_replyable.

Какие провайдеры вообще встречаются у площадки – в поле providers списка площадок.

Как подключить площадки

Возможность отвечать выдаётся на стороне площадки: владелец организации добавляет нашу учётную запись в свой кабинет. Ниже – инструкции по подключению.

Ответить, заменить, удалить

Ответ у отзыва ровно один, поэтому и метод один: PUT. Первый вызов публикует, повторный с новым текстом – заменяет. Повтор с тем же текстом ничего не ломает: это не дубль и не ошибка.

DELETE удаляет ваш ответ с площадки. Удалить можно только свой: ответ, опубликованный не через нас, методу не виден.

Что происходит с ответом

Состояние ответа – status в GET /reply. Оно говорит, что стоит на карточке:

PUT и DELETE возвращают состояние на момент приёма, а это всегда null: новый текст начинает путь заново, даже если предыдущий ответ уже стоял на площадке. Что было дальше, показывает GET /v3/reviews/{review_id}/reply – по тому же адресу, отдельного идентификатора у ответа нет.

curl https://api.rewio.ru/v3/reviews/143046/reply -H "X-API-Key: hrev_ВАШ_КЛЮЧ"
# -> { "status": "published", "submitted_at": "2026-10-14T15:12:01",
#      "published_at": "2026-10-14T15:12:40", "error": null, … }

submitted_at – когда вы отправили этот текст, published_at – когда мы увидели его на карточке. Ручка читает нашу запись и на площадку не ходит, поэтому опрашивать её можно сколько нужно. Чтение доступно и ключу на чтение и не зависит от тарифа.

Как мы узнаём, что ответ на карточке

Когда площадка приняла ответ, мы сами читаем этот отзыв на ней – через 15 и 30 секунд, через 1, 2, 3, 5, 15 и 30 минут, через 1, 2 и 4 часа. Как только видим ваш текст, ставим published; обычно это первые минуты. Если за 4 часа текст так и не появился – failed с кодом not_visible.

Так читаются Яндекс Карты, 2ГИС и Google. На других площадках (ПроДокторов и прочие) отдельный отзыв так не прочитать, и ответ подтверждает сбор карточки; если за сутки сбор нашего текста не нашёл – тоже failed с not_visible.

Сбор площадки двигает статус так же: принёс ваш текст – published, даже если перед этим было failed. Если сбор под опубликованным ответом текста больше не видит, мы перечитываем отзыв, и если ответа действительно нет – deleted с причиной:

Поля reply_text и reply_date самого отзыва в GET /reviews по-прежнему заполняет сбор, поэтому status: published может прийти раньше, чем ваш текст появится в reply_text. Если настроены вебхуки, о появлении ответа в отзыве приходит replies.new.

Если что-то пошло не так

Отказы, которые видны сразу, приходят в ответе на запрос: тариф без ответов, площадка не поддерживает ответы, отзыв не нативен для площадки (reply_not_replyable), место под ответ занято другим аккаунтом, текст не прошёл проверку, доступ отозван. Каждый – со своим кодом, все они на странице Ошибки.

Дальше, при самой публикации, мешать может временное: наш доступ к площадке обновляется, площадка просит подождать, сорвалась сеть. Такие случаи мы отрабатываем сами, повторами, а результат виден в состоянии ответа (status: failed и код в error). Если площадка приняла запрос, но ответ на карточке так и не появился, код – not_visible; если не сняла ответ, хотя приняла снятие, – not_taken_down.

Если ответ не появился, напишите на info@rewio.ru.