Что такое…

Что такое пуш-токен — и почему он меняется сам по себе

Иллюстрация: почтовый адрес на карточке, который сам собой переписывается на новый

Смотри, какая штука. У тебя в базе тысяча пуш-токенов, ты шлёшь уведомление — доходит до семисот. Никто не отписывался, приложение не удаляли. Просто триста адресов протухли, и это не баг, а нормальная жизнь пуш-токена.

Разберёмся, что это за адрес такой, почему он меняется сам и что с этим делать, чтобы твоя рассылка не превращалась в стрельбу по пустым квартирам.

Что такое пуш-токен простыми словами

Пуш-токен — это длинная строка, адрес, по которому можно доставить уведомление на конкретную установку твоего приложения на конкретном телефоне.

Три слова здесь важны:

  • Адрес, а не имя. Ты шлёшь не «Пете», а на адрес. Если Петя поставил приложение на телефон и планшет — это два разных токена.
  • Выдаёшь его не ты. Токен приходит от службы уведомлений операционной системы: APNs у Apple, FCM у Google. Твой сервер лишь получает готовую строку.
  • Он про установку. Удалили приложение и поставили заново — адрес другой. Тот же человек, тот же телефон, но новая «квартира».

Само по себе наличие токена ничего не гарантирует. Нужно ещё разрешение на уведомления — без него токен есть, а уведомления не показываются.

Как пуш вообще доходит

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

Цепочка всегда такая:

  1. Приложение при запуске просит у системы токен.
  2. Система выдаёт строку и отправляет её приложению.
  3. Приложение шлёт токен на твой сервер — обычным запросом к твоему API.
  4. Когда нужно уведомление, твой сервер обращается не к телефону, а к APNs или FCM: «доставь вот это вот по такому адресу».
  5. Служба уведомлений держит с телефоном свой канал и доставляет сама.

Поэтому у тебя нет способа «проверить, дошло ли». Ты отдаёшь письмо на почту — дальше её зона ответственности.

Почему токен живёт своей жизнью

Вот тут самое интересное. Apple прямо перечисляет случаи, когда токен гарантированно будет другим: пользователь восстановил телефон из резервной копии, поставил приложение на новое устройство, переустановил операционную систему. И даёт жёсткое правило: приложениям никогда не следует кэшировать токены — запрашивай у системы при каждом запуске.

Причина не в занудстве. В документации есть важная деталь: когда токен изменился, пользователь должен хотя бы раз открыть приложение, прежде чем уведомления снова начнут доходить. То есть после смены телефона твои пуши молчат ровно до первого запуска — и, если ты кэшировал старый адрес, молчат навсегда.

Со стороны сервера тоже есть срок годности. У Google для Android сказано конкретно: если регистрация неактивна 270 дней, FCM считает её просроченной и удаляет.

Что с этим делать: четыре правила

  • Запрашивай токен при каждом старте приложения. Если он не изменился, система вернёт его мгновенно — это дёшево. Если изменился, ты узнаешь сразу.
  • Отправляй на сервер вместе с датой. Храни в базе не просто строку, а «токен + когда его последний раз видели». Так ты отличишь живой адрес от забытого два года назад.
  • Удаляй мёртвые. Если служба уведомлений отвечает, что регистрация недействительна — у FCM это UNREGISTERED и код 404 — документация говорит прямо: такую запись можно спокойно удалять. Не удаляешь — платишь временем и лимитами за отправку в никуда.
  • Готовься к «много токенов на одного». Привязывай токены к пользователю списком, а не полем. Иначе вход с планшета молча выключит уведомления на телефоне.

Где ты встретишь его первым

Обычно — в первый же вечер, когда подключаешь уведомления через готовый сервис. Firebase, OneSignal и подобные прячут половину сложности, но не эту: в их инструкции всегда есть шаг «отправьте полученный токен на свой сервер» и обработчик «токен обновился».

Дальше у тебя в базе появляется табличка вида «пользователь — токен — платформа — когда обновлён». Именно она со временем зарастает мёртвыми адресами, если не делать четвёртый пункт из списка выше. Хорошая привычка на старте: сразу заведи поле с датой и раз в неделю смотри, сколько записей не обновлялось месяцами. Обычно это первое, что объясняет разрыв между «у нас тысяча пользователей» и «уведомление увидели семьсот».

Пуш-токен — это секрет?

Не такой, как ключ API, но и не публичные данные. Сам по себе чужой токен позволяет отправлять уведомления только тому, у кого есть твои серверные ключи. А вот в связке с ними — это прямой канал в чужой телефон. В логи и в клиентский код его выкладывать не надо.

Почему уведомление не пришло, хотя токен есть?

Три частые причины, по убыванию: нет разрешения на уведомления; токен устарел и его не обновили при запуске; телефон в режиме экономии, и доставка отложена до пробуждения. Начинай проверку сверху — она бесплатная.

Токен нужно генерировать самому?

Нет, и не пытайся. Токен выдаёт только служба уведомлений операционной системы, и никакая библиотека этого не обходит. Твоя задача — вовремя его получить, сохранить с датой и вовремя выбросить.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →