Настройка App Inbox для мобильных приложений

App Inbox – еще один вариант коммуникации с вашими клиентами, предоставляемый eSputnik. Он позволяет отправлять уведомления в автоматическом и ручном режиме в их личный кабинет в мобильном приложении.

Общее описание App Inbox, его применение, преимущества в сравнении с другими каналами рассылки вы можете найти в статье “App Inbox: почему вы оцените этот канал и как его эффективно использовать”.

Настройка App Inbox для мобильных приложений

Настройка App Inbox включает в себя отправку запросов:

• Получение токена идентификации.
• Получение количества непрочитанных App Inbox сообщений.
• Получение количества страниц с сообщениями.
• Получение списка всех App Inbox сообщений в мобильном приложении.
• Изменение статуса App Inbox сообщений.

Получение токена аутентификации

Для получения токена аутентификации пользователя (authToken) отправляется запрос с вашего сервера к API eSputnik. Запрос должен быть аутентифицирован одним из способов, описанных в инструкции к API. Например, API-ключом. 

В запросе необходимо передать известные поля пользователя: email, phone, externalCustomerId (хотя бы одно поле должно быть обязательным). Эти поля нужны для поиска контакта в eSputnik.

{ "email": string, "phone": string, "externalCustomerId": string }
JSON
COPY

{
"token": string
}
JSON
COPY

В дальнейшем authToken используется для аутентификации всех App Inbox запросов. Его нужно передавать в заголовке запроса ES-TOKEN. После каждого запроса текущий токен инвалидируется, а в заголовке ответа ES-TOKEN приходит новый, который используется для следующего запроса.

Если в ответ на любой App Inbox запрос приходит статус 401, то запрос на получение токена необходимо повторить.

Получение количества непрочитанных App Inbox сообщений

Запрос дает вам возможность получать информацию о количестве непрочитанных сообщений в мобильном приложении клиента. Запрос может выполняться регулярно.

{
"count": int
}
JSON
COPY

Если значение count > 0, пользователь должен увидеть индикатор непрочитанных сообщений.

Получение списка App Inbox сообщений

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

• id сообщения;
• дата создания;
• заголовок;
• текст сообщения;
• URL изображения;
• URL ссылки;
• статус сообщения (OPENED, UNOPENED);
• категорию сообщения;
• custom data.

{  
"list": [{  
"id" : string, // UUID  
"createdDate" : long, //timestamp in milliseconds  
"title": text,  
"content": text,  
"image": string, // URL  
"link": string, // URL  
"newMessage" : boolean // true for unread message  
"status" : OPENED, UNOPENED // message status  
},...],  
	"totalPages": int  
}
JSON
COPY

Если page, status или pageSize не установлены, вернутся все актуальные сообщения.

Изменение статуса App Inbox сообщений

Запрос используется для передачи события о прочтении сообщения. Необходимо передавать только идентификаторы сообщений, у которых newMessage=true.

При помощи запроса также можно изменить статус всех сообщений с "непрочитанное" на "прочитанное".

{
"status" : "OPENED",
"ids": [string]
}
JSON
COPY

{
"status": "OPENED",
"ids": null   //либо не передавать параметр вовсе
}
JSON
COPY

Создание группы контактов, доступных для рассылки

Все контакты, попадающие в eSputnik через SDK, имеют Device ID. Это означает, что им можно отправить рассылку App Inbox.

Чтобы выделить все контакты в вашей базе, которые имеют Device ID, создайте условную группу и включите в нее условие "Все контакты с девайсом".

Создание App Inbox сообщений

Инструкция по созданию App Inbox сообщений и их рассылке представлена на странице “Создание App Inbox cообщений”.