← Все статьи
Гайд

LINE push возвращает 200, но сообщения нет: проверьте получателя

Запрос push в LINE Messaging API может вернуть HTTP 200, хотя пользователь не получит сообщение. LINE прямо перечисляет удалённые аккаунты, пользователей, заблокировавших отправляющий Official Account, и тех, кто не добавил его в друзья и не подпадает под исключение. Перед повторной отправкой проверьте фактический канал, ID получателя и его отношения с этим аккаунтом. Успешный HTTP-ответ не доказывает ни доставку, ни блокировку.

Главное

  • Проверяйте исходящий push-запрос, а не ответ 200 вашего webhook-сервера.
  • Пользователю, который не добавил аккаунт в друзья, можно отправить push в течение семи дней после его сообщения этому Official Account в личном чате.
  • Это не универсальное окно для посетителей сайта, участников группы или всех вошедших пользователей.
  • После подтверждённого успеха запроса остановите автоматические повторы; проверьте условия и сохраните неопределённость доставки.

Почему успешный LINE push может не дойти

Справочник LINE Messaging API перечисляет следующие условия отправки push:

ПолучательУсловие из документации
Отдельный пользовательДобавил отправляющий LINE Official Account в друзья
Групповой чат или чат с несколькими участникамиOfficial Account присоединился к этому чату
Пользователь, не добавивший аккаунт в друзьяНаписал этому Official Account в личном чате за последние семь дней

Тот же справочник предупреждает: запрос может вернуть 200 без доставки пользователю, который удалил аккаунт LINE, заблокировал отправляющий Official Account либо не добавил его в друзья и не соответствует исключению.

Это возможные причины, а не диагноз, закодированный в успешном ответе. Не ставьте в CRM отметку «клиент нас заблокировал» только по жалобе на отсутствие сообщения. Условия также зависят от типа адресата: взаимодействие в группе не доказывает наличие подходящего личного сообщения.

Для отложенной поддержки рекомендуется отдельно хранить время соответствующего входящего сообщения, создания задания и фактической отправки. Повторно проверяйте условие для пользователя, не добавившего аккаунт в друзья, перед отправкой из очереди. Запуск AI-задачи внутри семидневного периода не резервирует право отправить результат позже.

Проследите одну отправку от канала до адресата

Ниже — рекомендуемые диагностические записи приложения, а не дополнительные поля LINE API.

1. Найдите нужный ответ

Убедитесь, что 200 пришёл именно на исходящий push. Успешный ответ вашего webhook подтверждает только приём запроса сервером. Успех собственного API очереди может означать лишь сохранение задания.

Сохраните метод, endpoint, время, HTTP-статус и x-line-request-id. Рекомендации LINE по разработке советуют вести такие журналы запросов. Не записывайте access token и не копируйте содержимое сообщений клиентов в обычные логи.

2. Проверьте отправителя вместе с адресатом

Выясните, какой channel access token выбрал работающий worker, какому Official Account принадлежит канал и откуда взялся ID назначения. Тестовый и рабочий аккаунты могут называться похоже. Снимок настроек не подтверждает, что worker использовал именно их.

Руководство LINE по user ID отличает API user ID от отображаемого имени и LINE ID для поиска друзей, а также определяет его область по provider. Если адресат получен через LINE Login или другую интеграцию, проверьте сопоставление по инструкции о несовпадении provider. Сам по себе вход на сайт не подтверждает добавление отправляющего Official Account в друзья.

3. Установите отношения с конкретным Official Account

Для отдельного пользователя проверьте имеющиеся подтверждения добавления в друзья либо недавнего подходящего сообщения в личном чате именно с этим Official Account. Старое действие в CRM, просмотр страницы или сообщение другому аккаунту — не равноценные доказательства.

Если данных недостаточно, оставьте состояние неизвестным. Не отправляйте повторные пробные сообщения, чтобы угадать наличие блокировки. Рекомендации LINE запрещают массовые отправки одному пользователю; диагностика не должна превращаться в нежелательное общение.

4. Разделяйте принятие, отказ и неизвестный результат

НаблюдениеСледующее действие
Push вернул 200, пользователь сообщает об отсутствии сообщенияПроверить идентификаторы и условия; не отправлять автоматически повторно
API вернул неуспешный ответРазобрать именно этот ответ, а не применять сценарий 200
Запрос завершился тайм-аутом без ответаСохранить неизвестный результат принятия и перейти к отдельной процедуре повторов
Только webhook вернул 200Проверить, выполнялся ли исходящий запрос вообще

Для тайм-аутов используйте руководство по LINE retry key. Защита повторов решает неопределённость принятия запроса. Она не меняет условия получателя и не делает недоставляемый успешный запрос доставляемым.

Проведите контролируемую проверку вместо цикла повторов

С согласия тестового пользователя проверьте точный Official Account в приложении LINE и нужное добавление в друзья. Отправьте одно легко узнаваемое тестовое сообщение через тот же работающий канал. Сопоставьте HTTP-запись с тем, что человек действительно видит в чате, а не только с баннером уведомления.

Успех подтверждает работоспособность пути для этого пользователя в этот момент. Он не устанавливает отношения другого клиента с аккаунтом, не объясняет все прошлые пропуски и не оправдывает повтор старых заданий.

Логику отложенных заданий можно проверить локально: семидневное условие перестаёт выполняться до отправки; сохранённый адресат относится к другой интеграции; уже принятое действие попадает в worker повторов. Ожидаемые результаты — приостановка задания, проверка идентификатора и отсутствие дубликата соответственно. Это предлагаемые тесты, а не результаты работы в production.

Доказательства UnifyPort относятся к отдельному пути

Неофициальный интерфейс UnifyPort подключает отдельный аккаунт обмена сообщениями. Контракт отправки текста использует account_id, to и message; в примере успешного ответа указан status: accepted. Это не квитанция о доставке и не восстановление прежнего push от Official Account.

Матрица событий провайдеров описывает отображение событий доставки и прочтения LINE, но не гарантирует, что каждый аккаунт или развёртывание создаёт все такие события. Применяйте полученную квитанцию только к указанным в ней сообщениям. Отсутствие квитанции не доказывает сбой или блокировку. Не связывайте квитанцию другого аккаунта с официальным push лишь по совпадению отображаемого имени.

Если отправителем должен оставаться LINE Official Account, используйте официальный Messaging API. Смена отправителя — не автоматическое восстановление и не отмена выбора получателя.

Частые вопросы

Доказывает ли HTTP 200, что клиент заблокировал Official Account?

Нет. Он не доказывает доставку и не указывает причину её отсутствия. LINE описывает несколько возможных условий.

Можно ли отправить push пользователю, не добавившему аккаунт в друзья?

LINE предусматривает исключение для тех, кто написал этому Official Account в личном чате за последние семь дней. Не распространяйте его на посещение сайта или взаимодействия в группе.

Нужно ли отправить ещё раз, если сообщение не появилось?

Не автоматически после известного успеха запроса. Сначала проверьте отправителя, адресата, условия и доказательства. Тайм-аут — другой случай, чем полученный 200.

Следующий шаг и источники

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

Официальные источники проверены 2026-11-18:

UnifyPort API

Превратите интеграцию сообщений в стабильный продуктовый pipeline.

Начните с отправки через единый API, затем возвращайте входящие сообщения в бизнес-систему стандартными событиями.