> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/email/03-delivery-operations.md).

# Проверка доставки и очередей

## Что вы получите

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

## Три разных доказательства

{% columns %}
{% column %}

### 1. Подключение

Сервер смог обратиться к SMTP, Resend или Telegram с сохранёнными параметрами.
{% endcolumn %}

{% column %}

### 2. Событие

Действие в заявке создало нужное событие, выбрало аудиторию и поставило работу в очередь.
{% endcolumn %}

{% column %}

### 3. Доставка

Сообщение появилось у правильного получателя и содержит ожидаемые данные.
{% endcolumn %}
{% endcolumns %}

Ни один из этих уровней не заменяет два остальных.

## Проверьте E-mail-подключение

{% stepper %}
{% step %}

### Откройте почтовое подключение

Проверьте адрес и имя отправителя, включение подключения и отметку сохранённого секрета.
{% endstep %}

{% step %}

### Укажите контрольный адрес

Заполните **«E-Mail для проверки»** адресом, к которому у вас есть доступ. Не используйте реального клиента.
{% endstep %}

{% step %}

### Нажмите «Отправить тест»

Форма сначала сохраняет текущие параметры, затем отправляет проверочное письмо. Если почтовый транспорт отклонил отправку, интерфейс должен показать ошибку, а не успешный результат. При успехе проверьте входящие, спам, имя и адрес отправителя.
{% endstep %}

{% step %}

### Выполните «Проверить»

В списке подключений откройте действия строки и нажмите **«Проверить»**. Сверьте новое состояние и время проверки.
{% endstep %}
{% endstepper %}

Ответ провайдера «принято» означает только приём в обработку. Он не гарантирует папку «Входящие» и не подтверждает SPF, DKIM, DMARC или репутацию домена.

## Проверьте коды входа по E-mail

Эта проверка обязательна, если в настройках обмена используется режим **«Сначала подтвердить e-mail»**.

{% stepper %}
{% step %}

### Получите первый код

На клиентском сайте используйте принадлежащий вам зарегистрированный адрес. Письмо должно быть принято транспортом, появиться в конечном ящике и содержать рабочий код.
{% endstep %}

{% step %}

### Проверьте отказ первой отправки

В безопасном контрольном окне воспроизведите отказ тестового почтового подключения. Клиент должен увидеть ошибку отправки и не должен получить ложное сообщение об успешном коде.
{% endstep %}

{% step %}

### Проверьте неудачную повторную отправку

Сначала получите рабочий код, затем воспроизведите отказ при запросе нового. После ошибки введите прежний неизрасходованный код: он должен оставаться действительным до обычного истечения.
{% endstep %}
{% endstepper %}

Не ломайте рабочее почтовое подключение во время приёма клиентов. Для негативного сценария используйте отдельное контрольное подключение, согласованное окно или подготовленную среду.

## Проверьте реальное событие

1. Создайте новую контрольную заявку с отдельным принадлежащим вам E-mail.
2. Выполните действие, которому соответствует одна строка матрицы.
3. Зафиксируйте ID заявки и время действия.
4. Проверьте правильного получателя, тему, язык, данные заявки и отсутствие секретов.
5. Убедитесь, что нежелательное второе подключение не создало дубль.
6. Повторите для клиентской и административной аудиторий.
7. После успешной проверки измените в матрице **«Не проверено»** на фактический результат.

{% hint style="danger" %}
Не переводите заявку клиента в ложный платёжный статус ради проверки. Используйте специально созданную контрольную заявку и меняйте статус только по согласованному сценарию.
{% endhint %}

## Проверьте фоновые процессы

Уведомления обрабатываются тремя очередями:

* `notifications-high`;
* `notifications-normal`;
* `notifications-low`.

Откройте **«Утилиты» — «Horizon и Pulse» — «Laravel Horizon»**. У сотрудника должно быть право на служебные ссылки панели.

Проверьте:

* работают ли отдельные обработчики каждой очереди;
* не растёт ли число ожидающих заданий;
* нет ли повторяющихся ошибок одного события;
* соответствует ли задержка назначенному приоритету;
* восстановились ли задания после кратковременной недоступности Redis или провайдера.

Планировщик регулярно подбирает неотправленные записи и служебные сводки. Поэтому исправный cron и работающие обработчики нужны даже тогда, когда проверка соединения прошла.

## Ищите разрыв слева направо

```mermaid
flowchart LR
    A["Главный переключатель"] --> B["Переключатель канала"]
    B --> C["Подключение включено"]
    C --> D["Событие сохранено"]
    D --> E["Получатель найден"]
    E --> F["Очередь обработана"]
    F --> G["Провайдер принял"]
    G --> H["Сообщение доставлено"]
```

| Симптом                                          | Где проверить сначала                                                       |
| ------------------------------------------------ | --------------------------------------------------------------------------- |
| Все каналы молчат                                | Главный переключатель и планировщик                                         |
| Не работает только почта                         | Переключатель E-mail, подключение, DNS и провайдер                          |
| Проверочное письмо приходит, событие нет         | Каталог событий, аудитория, модель получателя и очередь                     |
| Одно сообщение приходит дважды                   | Одинаковое событие в нескольких подключениях или повторная обработка        |
| Telegram-бот найден, но чат молчит               | Место доставки, права бота, аудитория и событие                             |
| В Horizon растёт очередь                         | Обработчики, Redis, ошибка задания и доступность провайдера                 |
| Провайдер принял, письма нет                     | Журнал провайдера, спам, bounce, SPF/DKIM/DMARC и репутация                 |
| Интерфейс сообщил об отправке, транспорт отказал | Повторная проверка подключения, журнал ошибки и фактический результат теста |
| Новый код не отправился                          | Введите прежний неизрасходованный код и восстановите почтовое подключение   |

## Безопасное восстановление

{% stepper %}
{% step %}

### Зафиксируйте границу отказа

Запишите подключение, событие, аудиторию, время и состояние очереди без копирования секрета.
{% endstep %}

{% step %}

### Исправьте одну причину

Например, восстановите обработчик, исправьте адрес отправителя или замените отозванный ключ.
{% endstep %}

{% step %}

### Повторите проверку подключения

Убедитесь, что состояние подключения снова корректно.
{% endstep %}

{% step %}

### Создайте новое событие

Не считайте старую запись единственным доказательством. Вызовите новое безопасное событие и проверьте конечного получателя.
{% endstep %}

{% step %}

### Проверьте отсутствие дублей

После восстановления убедитесь, что повторная обработка не отправила клиенту несколько одинаковых сообщений.
{% endstep %}
{% endstepper %}

## Этап завершён, если

* [ ] подключение проверено для каждого используемого канала;
* [ ] отказ почтового транспорта показывается как ошибка, а не как успех;
* [ ] первый и повторный E-mail-коды проверены, прежний код сохраняется при неудачной повторной отправке;
* [ ] реальное событие дошло каждой заявленной аудитории;
* [ ] проверены входящие, спам и журнал провайдера;
* [ ] три очереди обрабатываются без опасного накопления;
* [ ] повторная проверка не создаёт дублей;
* [ ] команда умеет найти разрыв по всей цепочке;
* [ ] после исправления проверяется новое событие, а не только старый статус.

Далее подготовьте [почтовый домен и адреса](/learn/email/04-email-foundation.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/email/03-delivery-operations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.