Система отслеживания писем-возвратов
From LimeSurvey Manual
Введение
Система отслеживания писем-возвратов позволяет находить и отмечать e-mail, которые не были доставлены получателям (участникам опроса). Система использует «отчёт об ошибке доставки уведомления по e-mail». Поэтому ей нужен адрес e-mail, на который будут приходить письма-возвраты. Помимо адреса, необходимы также учётные данные этого аккаунта и параметры подключения.
Требования
На вашем сервере должен быть установлен модуль php5-imap. Проверить это можно с помощью кнопки Показать PHPInfo, расположенной на странице общих настроек вашей установки LimeSurvey, на вкладке Обзор:
Затем найдите раздел imap (для быстрого поиска нажмите Ctrl+F). Если раздел imap отображается, всё в порядке:
Если php5-imap не установлен, а у вас есть root-доступ к серверу, вы можете установить его, следуя процедуре для вашего дистрибутива. Например, если вы используете Debian, перейдите по этой ссылке. Не забудьте перезапустить веб-сервер после установки (например, выполните в терминале команду "apache/usr/sbin/apache2ctl restart").
Как это работает
Система разрабатывалась для того, чтобы сократить объём ручной работы и уменьшить количество возможных ошибок, возникающих при ручном редактировании каждого поля.
Основная идея системы в том, что при отправке e-mail она автоматически добавляет в заголовок письма идентификатор опроса и идентификатор токена, незаметно для администратора.
Эти заголовки (также называемые пользовательскими заголовками) добавляются в каждое сообщение с приглашением, отправляемое участникам опроса через LimeSurvey.
Когда письмо возвращается, приходит исходный заголовок вместе с заголовком уведомления о доставке. Затем система проверяет новые письма и анализирует те из них, которые содержат эти пользовательские заголовки. Она выделяет красным цветом шрифта неверные адреса e-mail в таблице участников опроса.
Настройка системы
Система может работать глобально (для всех опросов) или локально (только для определённого опроса), поэтому настройки можно сохранять соответствующим образом. Общие настройки писем-возвратов можно сохранить в разделе Общие настройки -> Настройки писем-возвратов. Будут отображены следующие параметры:
- Адрес e-mail для писем-возвратов: адрес e-mail, на который будут отправляться письма-возвраты. Для более быстрой обработки таких писем рекомендуем использовать адрес, который применяется только для системы отслеживания писем-возвратов LimeSurvey.
- Тип сервера: если выбрано значение «Выкл», функции обработки писем-возвратов будут недоступны. Выберите «POP» или «IMAP», чтобы использовать систему отслеживания писем-возвратов LimeSurvey.
- Имя и порт сервера: имя сервера и (при необходимости) порт, разделённые двоеточием. Номер порта обычно не требуется, если почтовый хост не использует нестандартный порт.
- Имя пользователя: имя пользователя для учётной записи POP/IMAP.
- Пароль: пароль для учётной записи POP/IMAP.
- Тип шифрования: если используется шифрование, выберите здесь нужный тип (SSL или TLS).
Если вы хотите применить настройки писем-возвратов только к одному опросу, откройте нужный опрос -> перейдите в меню опроса и нажмите на вкладку Участники опроса -> на главной панели инструментов страницы выберите пункт Приглашения и напоминания -> нажмите Настройки писем-возвратов. Будет загружена следующая страница:
Дополнительный параметр — Используемые настройки писем-возвратов. Здесь можно выбрать, что использовать:
- без настроек писем-возвратов;
- локальные настройки писем-возвратов. Если выбран этот вариант, необходимо заполнить остальные поля локальных настроек писем-возвратов;
- общие настройки писем-возвратов. В этом случае будут использованы настройки писем-возвратов вашей установки LimeSurvey.
Примечание. LimeSurvey будет устанавливать SMTP-соединение с IP-адреса вашей установки LimeSurvey. Чтобы узнать его, выполните ping для URL установки LimeSurvey. Если доступ к вашему SMTP-серверу ограничен, потребуется добавить этот IP-адрес как исключение в конфигурацию SMTP или брандмауэр.
Использование почтового сервера LimeSurvey Cloud
Если вы используете почтовый сервер LimeSurvey Cloud, во всех ваших e-mail в качестве адреса отправителя будет указан "noreply@limesurvey.org". Однако в этих письмах будет заголовок Reply-to с вашим адресом электронной почты. Поэтому, если кто-то попытается ответить, он сможет написать вам напрямую.
Письма-возвраты обрабатываются автоматически, если вы используете сервер LimeSurvey Cloud. Вам не нужно ничего настраивать и запускать обработку писем-возвратов, просто оставьте настройки по умолчанию без изменений. Всё происходит автоматически в фоновом режиме. Обратите внимание, что обработка письма-возврата и отметка соответствующей записи могут занять 10–15 минут.
Пожалуйста, не используйте LimeSurvey Cloud для рассылки спама, иначе нам придётся заблокировать вашу учётную запись. Убедитесь, что у вас есть согласие людей, которым вы хотите отправлять приглашения.
Запуск обработки писем-возвратов
Прежде чем запускать обработку писем-возвратов, не забудьте сначала отправить приглашения на e-mail участникам опроса.
В версии 3.0+ после настройки системы отслеживания писем-возвратов вы можете запустить обработку писем-возвратов: перейдите на главную страницу опроса -> откройте вкладку Участники опроса в меню опроса -> нажмите Приглашения и напоминания (на панели инструментов) -> Начать обработку писем-возвратов.
После выбора этой опции во время обработки будет отображаться индикатор выполнения, а затем итоговая сводка о состоянии обработки.
Начнётся проверка отправленных приглашений. Результаты проверки будут показаны в таблице участников опроса (возможно, потребуется вручную обновить страницу). Адреса электронной почты всех записей, приглашения для которых вернулись, будут выделены красным шрифтом. Также их Статус e-mail изменится с «OK» на «bounced».
Запуск обработки писем-возвратов в версии 2.5
В версии 2.50+ после настройки системы обработки писем-возвратов вы можете запустить обработку писем-возвратов с главной страницы опроса: Приглашения и напоминания -> Начать обработку писем-возвратов.
После выбора этой опции во время обработки будет отображаться индикатор выполнения, а затем итоговая сводка о состоянии обработки.
Начнётся проверка отправленных приглашений. Результаты проверки будут показаны в таблице участников опроса (возможно, потребуется вручную обновить страницу). Адреса электронной почты всех записей, приглашения для которых вернулись, будут выделены красным шрифтом. Также их Статус e-mail изменится с «OK» на «bounced».
Внимание : В некоторых выпусках v2.50+ этот пункт меню отображается неправильно. Проблема была исправлена в сборке 160714, выпущенной 14 июля 2016 года.
Пример
Чтобы лучше понять, как работает система отслеживания писем-возвратов LimeSurvey, рассмотрите следующий пример:
1. Добавьте респондентов в таблицу участников опроса. Убедитесь, что у каждого из них есть назначенный токен и адрес электронной почты.
2. Выберите респондентов, которым вы хотите отправить приглашение к опросу:
Нажмите кнопку Выбранный(е) участник(и)... и выберите опцию Отправить приглашения на email.
3. Подождите некоторое время, чтобы убедиться, что письма отправлены респондентам.
4. Теперь вы можете использовать систему отслеживания писем-возвратов LimeSurvey. Нажмите Приглашения и напоминания и заполните поля настроек писем-возвратов данными подключения и учётной записи вашей личной электронной почты:
Вы также можете оставить поля пустыми. Обработка писем-возвратов всё равно будет работать, но вы не будете получать e-mail, связанные с обработкой писем-возвратов. Однако статус e-mail записей в таблице участников опроса будет обновлён.
Как видно ниже, мы используем систему отслеживания писем-возвратов с бесплатной учётной записью Gmail. Чтобы узнать о настройках подключения для Gmail, перейдите по следующей ссылке. Также не забудьте включить IMAP/POP в настройках вашей учётной записи Gmail.
Gmail может расценить подключение к вашей учётной записи LimeSurvey как небезопасное. Чтобы LimeSurvey мог подключиться к вашей учётной записи Gmail, потребуется разрешить небезопасным приложениям доступ к вашей учётной записи.
Заполните поля. Выберите нужные настройки сервера и шифрования. Затем нажмите кнопку Сохранить в правом верхнем углу экрана.
5. Теперь можно нажать кнопку Начать обработку писем-возвратов:
Система отслеживания писем-возвратов начнёт искать идентификатор опроса (survey-id), идентификатор токена (token-id) и уведомление о доставке, которые добавлены в заголовок каждого письма-возврата. Если эти пользовательские заголовки найдены, система изменит цвет шрифта неверных адресов e-mail в таблице участников опроса на красный. Кроме того, статус e-mail соответствующих записей изменится с OK на bounced.
