Copy page

Центр уведомлений

Интеграция с центром уведомлений через модуль «Уведомления и мессенджеры»

Если в вашем мобильном приложении или личном кабинете есть центр уведомлений (ЦУ), Mindbox может отправлять в него рассылки из модуля «Уведомления и мессенджеры». Маркетолог создает рассылку в канале «Центр уведомлений», Mindbox передает сообщение на ваш сервер, а ваш сервер возвращает в Mindbox открытия, клики и недоставки — они попадают в статистику рассылки.

Перед началом

Убедитесь, что:

• Подключен модуль Mindbox «Уведомления и мессенджеры» в разделе Подписка и оплата — подробнее.
• Ваш сервер доступен из интернета по HTTPS. Mindbox и ваш сервер обмениваются запросами только по HTTPS.

Шаг 1. Создайте endpoint для приема сообщений

Endpoint для приема сообщений создаете вы: Mindbox не генерирует этот адрес. Endpoint должен принимать POST-запросы и быть доступен из интернета. Путь и логику обработки выберите сами. Адрес endpoint указывается в соединении в поле «Адрес доступа», об этом — в шаге 2.

Mindbox отправляет каждое сообщение отдельным POST-запросом со скоростью до 750 сообщений в секунду.

Заголовки запроса

Как проверить, что запрос пришел от Mindbox

Mindbox авторизуется на вашем сервере по схеме Basic: в каждом запросе приходит заголовок Authorization: Basic <base64(логин:пароль)>. Раскодируйте этот заголовок и сверьте логин и пароль с теми, что указали в соединении. Так вы убедитесь, что запрос пришел от Mindbox, а не от постороннего.

Чтобы проверить запрос:

1. Возьмите значение заголовка Authorization.
2. Уберите префикс Basic.
3. Декодируйте оставшуюся строку из Base64 — получится строка вида логин:пароль.
4. Сравните логин и пароль с указанными в соединении.

Пример:

Code
Authorization: Basic YWRtaW46NjQ2YmVmYzktZTRhMC00NTgyLTlkN2ItMTY3OGUzZThjNmQw

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

Code
admin:646befc9-e4a0-4582-9d7b-1678e3e8c6d0

Здесь admin — логин, 646befc9-e4a0-4582-9d7b-1678e3e8c6d0 — пароль.

Тело запроса

Code
{
  "messageId": "some_message_id_123",
  "clientId1": "user_12345",
  "clientId2": "79001234567",
  "campaignId": "promo",
  "title": "Заголовок",
  "text": "Это текст уведомления",
  "image": "https://example.com/image.png",
  "link": "https://example.com/promo",
  "buttons": [
    {
      "text": "Кнопка",
      "url": "https://example.com/new"
    }
  ],
  "payload": {
    "param1": "additionalData1",
    "param2": "additionalData2"
  }
}

Mindbox отправляет сообщение, только если у клиента заполнен хотя бы один из идентификаторов: clientId1 или clientId2. Определяйте по ним получателя на стороне приложения.

Ответ на запрос

Шаг 2. Передайте данные для настройки соединения

Соединение «Центр уведомлений» создается в Mindbox в разделе Настройки → Рассылки → Соединения.

Для настройки понадобится:

• Адрес endpoint из шага 1 — для поля «Адрес доступа»;

• Логин и пароль, с которыми Mindbox будет обращаться к endpoint;

• Название поля профиля клиента в Mindbox, в котором хранится идентификатор пользователя вашего приложения, — для полей «Идентификатор клиента 1» и «Идентификатор клиента 2».

  Если идентификатор может храниться в двух разных полях, укажите оба: для отправки достаточно любого из них.

Если у вас несколько брендов или приложений, для каждого нужно отдельное соединение — подготовьте данные для каждого.

Шаг 3. Отправляйте события в Mindbox

После сохранения соединения скопируйте URL из блока «Открытия и клики по рассылке». Это callback_url — на него ваш сервер будет отправлять POST-запросы с событиями.

Mindbox принимает три типа событий: открытие, недоставку и клик.

Заголовки запроса

Если Mindbox принял событие, он возвращает 200 OK.

Тело запроса

Открытие

Code
{
  "messageId": "some_message_id_123",
  "status": "opened",
  "time": "2025-03-13T13:44:39Z"
}

Недоставка

Code
{
  "messageId": "some_message_id_123",
  "status": "failed",
  "status_code": "status_code",
  "description": "Error description",
  "time": "2025-03-13T13:44:39Z"
}

Клик по кнопке без ссылки

Code
{
  "messageId": "some_message_id_123",
  "status": "clicked",
  "buttonText": "Click here",
  "time": "2025-03-13T13:44:39Z"
}

Mindbox записывает клик со ссылкой вида https://mbxs.ru/button/<текст кнопки>, например https://mbxs.ru/button/Click here.

Клик по ссылке

Отправляйте это событие, если ссылка не отслеживается кликтрекингом Mindbox и клики считает ваше приложение.

Code
{
  "messageId": "some_message_id_123",
  "status": "clicked",
  "url": "https://some-click-url.com",
  "time": "2025-03-13T13:44:39Z"
}

Mindbox записывает клик с переданной ссылкой.

Проверка результата

1. Попросите маркетолога отправить рассылку в канале «Центр уведомлений» на тестового клиента, у которого заполнено поле с идентификатором пользователя.
2. Проверьте, что endpoint получил запрос и ответил 200, а сообщение появилось в ЦУ.
3. Откройте сообщение в ЦУ и нажмите кнопку в нем.
4. Попросите маркетолога проверить, что открытие и клик появились в статусах рассылки у тестового клиента.

Что дальше

• Центр уведомлений на основе мобильных пушей — если ЦУ должен хранить пуши, отправленные через SDK Mindbox.
• Модуль «Уведомления и мессенджеры» — какие еще каналы доступны в модуле.