Последние авторы
author | version | line-number | content |
---|---|---|---|
1 | (% class="lead" %) | ||
2 | Push-уведомления доставляются клиенту через специальные сервисы отправки. | ||
3 | |||
4 | В Loymax Smart Communications реализована отправка push-уведомлений через **Cлужбу push-уведомлений [[Google Firebase Cloud Messaging Service>>https://firebase.google.com/]] (FCM)**. | ||
5 | |||
6 | По разным причинам, в том числе в результате действий клиента, состояние идентификатора мобильного устройства, push-токена и доступность** **push-уведомлений могут изменяться. | ||
7 | |||
8 | На стороне Loymax Smart Communications действующий push-токен определяется следующим образом: | ||
9 | |||
10 | При отправке рассылки на несколько push-токенов Smart Communications анализирует ответ, полученный от **Cлужбы push-уведомлений FCM**. При получении [[ошибки>>https://firebase.google.com/docs/cloud-messaging/send-message?hl=ru#rest-error]] push-токен помечается в БД Smart Communications невалидным, если параметр ##status## или ##errorCode## имеет одно из значений: | ||
11 | |||
12 | * ##INVALID_ARGUMENT## | ||
13 | * ##UNREGISTERED## | ||
14 | |||
15 | **Примеры ответов от Cлужбы push-уведомлений FCM**: | ||
16 | |||
17 | * Код ошибки HTTP = 400: | ||
18 | |||
19 | (% class="box" %) | ||
20 | ((( | ||
21 | ## "error": { | ||
22 | "code": 400, | ||
23 | "message": "The registration token is not a valid FCM registration token", | ||
24 | "status": "INVALID_ARGUMENT", | ||
25 | "details": [ | ||
26 | { | ||
27 | "@type": "type.googleapis.com/google.firebase.fcm.v1.FcmError", | ||
28 | "errorCode": "INVALID_ARGUMENT" | ||
29 | } | ||
30 | ] | ||
31 | }## | ||
32 | ))) | ||
33 | |||
34 | * Код ошибки HTTP = 404: | ||
35 | |||
36 | (% class="box" %) | ||
37 | ((( | ||
38 | ## "error": { | ||
39 | "code": 404, | ||
40 | "message": "Requested entity was not found.", | ||
41 | "status": "UNREGISTERED", | ||
42 | "details": [ | ||
43 | { | ||
44 | "@type": "type.googleapis.com/google.firebase.fcm.v1.FcmError", | ||
45 | "errorCode": "UNREGISTERED" | ||
46 | } | ||
47 | ] | ||
48 | }## | ||
49 | ))) | ||
50 | |||
51 | (% class="box infomessage" %) | ||
52 | ((( | ||
53 | Подробного описания, почему токен оказался невалидным, Сервис push-уведомлений FCM не даёт. Поэтому не представляется возможным найти истинную причину подобного ответа в каждом отдельном случае. | ||
54 | ))) | ||
55 | |||
56 | === Выбор устройств клиента для рассылки === | ||
57 | |||
58 | |(% style="border-color:white; width:912px" %)В интерфейсе Loymax Smart Communications можно настраивать, отправлять рассылку на все существующие у клиента push-токены, либо только на последний добавленный в БД по дате. Остальные устройства в таком случае игнорируются. По умолчанию установлена настройка **На все устройства**. Подробнее о настройках push-рассылок см. в [[статье>>doc:Main.Using.Smart_Communications.Settings_SC.Settings.WebHome||anchor="04"]].|(% style="border-color:white; width:531px" %){{lightbox image="push.png" width="500"/}} | ||
59 | |||
60 | (% class="box" %) | ||
61 | ((( | ||
62 | **Примечание:** | ||
63 | Проверка доставки уведомлений в Loymax Smart Communications не осуществляется**.** | ||
64 | ))) | ||
65 | |||
66 | (% class="box" %) | ||
67 | ((( | ||
68 | **Читайте также:** | ||
69 | |||
70 | * [[Общие настройки>>doc:Main.Using.Smart_Communications.Settings_SC.Settings.WebHome]] в Smart Communications | ||
71 | * [[Push-токены>>doc:Main.Using.Mobile_application.Push_token.WebHome]] в системе Loymax | ||
72 | * [[Учёт доступности push-уведомлений для клиента в системе Loymax>>doc:Main.Using.Mobile_application.Typical_processes.mobile_app_installation.Push_availability.WebHome]] | ||
73 | ))) |