Адресные push через API (интеграция с сайтом)

Раздел Интеграция (API) позволяет отправлять адресные (персональные) push-уведомления конкретному пользователю с вашего сервера по событию - например «Ваш заказ №1024 готов» именно тому, кто его оформил. В отличие от массовой рассылки, здесь уведомление уходит одному человеку.

Как это работает

1. Пользователь заходит в приложение - на странице сайта скрипт привязывает его устройство к его аккаунту на сайте.
2. На сайте происходит событие (например, заказ сменил статус).
3. Ваш сервер вызывает API Revs App и передаёт, кому и что отправить - пуш уходит нужному пользователю.

Шаг 1. API-ключ и белый список IP

1. Откройте раздел Интеграция (API) и включите интеграцию (тумблер «Интеграция включена»).
2. Создайте API-ключ. Он показывается один раз - сразу скопируйте и сохраните в секрете.
3. Укажите белый список IP (по одному в строке или через запятую) - адреса вашего сервера.

Шаг 2. Привязка пользователя (JS на сайте)

На странице сайта размещается небольшой скрипт, который связывает устройство пользователя с его идентификатором на сайте (ID клиента, номер телефона и т.п.). Это тот самый «Поле пользователя в payload» - по нему API потом находит, кому слать уведомление.

Шаг 3. Отправка пуша пользователю

Ваш сервер отправляет запрос к API Revs App: заголовок, текст, идентификатор пользователя и, при желании, «Ссылка при тапе (deeplink)» - куда открыть при нажатии.

В разделе есть готовые блоки: Пример запроса, Успешный ответ - скопируйте и адаптируйте под свой backend.

Готовые интеграции с CMS

Если сайт на популярной CMS, не нужно писать код с нуля: выберите свою CMS и нажмите «Настроить». Панель покажет:

• Предпросмотр на примере заказа;
• готовый пример запроса;
• ссылку на документацию по подключению.

Пример сценария

Интернет-магазин:

1. Клиент оформляет заказ в приложении → скрипт привязал его устройство к его user_id.
2. Заказ переходит в статус «Готов» → backend магазина вызывает API Revs App с user_id, заголовком «Заказ готов» и deeplink /orders/1024.
3. Клиент получает персональный пуш и по тапу попадает на страницу заказа.

Советы

• Обязательно заполняйте белый список IP - это ключевая защита.
• Храните API-ключ на сервере, никогда не в коде страницы (в браузере он был бы виден всем).
• Начните с готовой интеграции CMS, если ваш движок в списке - это быстрее и без ошибок.

Возможные ошибки

Сообщение	Решение
«Сначала создайте API-ключ»	Создайте ключ в этом разделе, прежде чем настраивать отправку.
Запрос отклонён	IP сервера не в белом списке - добавьте его.
Пуш не дошёл пользователю	Устройство не привязано (не сработал скрипт Шага 2) или неверный идентификатор пользователя.

Связанные статьи

• Отправка push-уведомлений
• Вебхуки
• Настройка Firebase (FCM) для push