Система відстеження недоставлених листів
From LimeSurvey Manual
Вступ
Система відстеження недоставлених листів здатна виявляти та позначати листи, які не були доставлені одержувачам (учасникам опитування). Система спирається на «звіт про збій сповіщення про доставку листа». Тому їй потрібна електронна адреса, на яку можна надсилати листи для відстеження баунсів. Окрім адреси облікового запису, потрібні також облікові дані цього запису та деталі підключення.
Вимоги
На вашому сервері має бути встановлений модуль php5-imap. Перевірити це можна за допомогою кнопки Показати PHPInfo на сторінці загальних налаштувань вашої інсталяції LimeSurvey, на вкладці Огляд:
Далі знайдіть розділ imap (скористайтеся Ctrl+F для швидкого пошуку). Якщо розділ imap відображається, все готово до роботи:
Якщо php5-imap не встановлено і ви маєте root-доступ до сервера, ви можете встановити його за процедурою, специфічною для вашого дистрибутива. Наприклад, якщо ви використовуєте Debian, перегляньте це посилання. Після встановлення не забудьте перезапустити веб-сервер (наприклад, виконайте в терміналі «apache/usr/sbin/apache2ctl restart»).
Як це працює
Основна ідея розробки системи полягала в тому, щоб зменшити обсяг ручної роботи та кількість можливих людських помилок, які можуть виникнути під час ручного редагування кожного поля.
Основна ідея цієї системи полягає в тому, що під час надсилання листа система відстеження недоставлених листів автоматично додає до заголовка листа ідентифікатор опитування та ідентифікатор токена, непомітно для адміністратора.
Ці заголовки (також відомі як користувацькі заголовки) додаються до кожного листа-запрошення, надісланого через LimeSurvey учасникам опитування.
Коли лист повертається, надходить початковий заголовок разом із заголовком сповіщення про доставку. Потім система перевіряє нові листи та обробляє ті, що мають ці користувацькі заголовки. Вона змінює колір шрифту неправильних електронних адрес у таблиці учасників опитування на червоний.
Налаштування системи
Система може працювати глобально (для всіх опитувань) або локально (лише для конкретного опитування), тож налаштування можна зберігати відповідно. Загальні налаштування баунсів можна зберегти в розділі Загальні налаштування -> Налаштування баунсів. Відобразяться такі параметри:
- Стандартне сповіщення сайту про збій доставки листа: Це електронна адреса, на яку надсилатимуться недоставлені листи. Для швидшої обробки недоставлених листів рекомендуємо використовувати адресу, яка застосовується лише для системи відстеження недоставлених листів 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, усі ваші листи матимуть адресу відправника "noreply@limesurvey.org". Проте ці листи міститимуть заголовок Reply-to з вашою електронною адресою. Тож якщо хтось спробує відповісти, він зможе написати вам безпосередньо.
Баунси автоматично обробляються, якщо ви використовуєте сервер LimeSurvey Cloud. Вам не потрібно нічого налаштовувати і не потрібно запускати обробку баунсу, просто залиште налаштування за замовчуванням без змін. Усе відбувається автоматично у фоновому режимі. Зверніть увагу, що обробка недоставленого листа та позначення відповідного запису можуть тривати 10–15 хвилин.
Будь ласка, не зловживайте LimeSurvey Cloud для розсилання спаму, інакше нам доведеться заблокувати ваш обліковий запис. Переконайтеся, що ви маєте згоду людей, яким хочете надсилати запрошення.
Запуск обробки баунсу
Перш ніж розпочати обробку баунсу, не забудьте спочатку надіслати запрошення по email учасникам вашого опитування.
У версії 3.0+ після налаштування системи відстеження недоставлених листів ви можете розпочати обробку баунсу. Для цього перейдіть на головну сторінку опитування -> натисніть вкладку Учасники опитування у меню опитування -> натисніть Запрошення та нагадування (на панелі інструментів) -> Розпочати обробку баунсу.
Після вибору цього пункту під час процесу відображатиметься індикатор виконання, а потім — підсумковий статус обробки.
Розпочнеться перевірка надісланих запрошень. Результати сканування відобразяться в таблиці учасників опитування (можливо, доведеться вручну оновити сторінку). Усі записи, запрошення для яких не були доставлені, матимуть email адреси, позначені червоним шрифтом. Також їхній Статус листа зміниться з "OK" на "bounced".
Запуск обробки баунсу у версії 2.5
У версії 2.50+ після налаштування системи обробки баунсу ви можете розпочати обробку баунсу з головної сторінки опитування: Запрошення та нагадування -> Розпочати обробку баунсу.
Після вибору цього пункту під час процесу відображатиметься індикатор виконання, а потім — підсумковий статус обробки.
Розпочнеться перевірка надісланих запрошень. Результати сканування відобразяться в таблиці учасників опитування (можливо, доведеться вручну оновити сторінку). Усі записи, запрошення для яких не були доставлені, матимуть email адреси, позначені червоним шрифтом. Також їхній Статус листа зміниться з "OK" на "bounced".
Увага : У деяких випусках v2.50+ цей пункт меню відображається неправильно. Цю проблему виправлено у збірці 160714, випущеній 14 липня 2016 року.
Приклад
Щоб краще зрозуміти, як працює система відстеження недоставлених листів LimeSurvey, перегляньте наведений нижче приклад:
1. Додайте респондентів до таблиці учасників опитування. Переконайтеся, що кожен із них має призначений токен та email адресу.
2. Виберіть респондентів, яким ви хочете надіслати запрошення до опитування:
Натисніть кнопку Вибрані учасники... і виберіть опцію Вислати запрошення по email.
3. Зачекайте кілька хвилин, щоб переконатися, що листи надіслано респондентам опитування.
4. Тепер ви можете скористатися системою відстеження недоставлених листів LimeSurvey. Натисніть Запрошення та нагадування і заповніть поля налаштувань баунсів даними підключення та облікового запису вашої особистої електронної пошти:
Ви також можете залишити поля порожніми. Обробка баунсу все одно працюватиме, лише ви не отримуватимете жодних листів, пов’язаних з обробкою баунсу. Проте статус листа для записів у таблиці учасників опитування буде оновлено.
Як видно нижче, ми використовуємо систему відстеження недоставлених листів із безкоштовним обліковим записом Gmail. Щоб дізнатися про налаштування підключення для Gmail, перейдіть за цим посиланням. Також не забудьте увімкнути IMAP/POP у налаштуваннях вашого облікового запису Gmail.
Gmail може розцінювати підключення до вашого облікового запису LimeSurvey як небезпечне. Щоб дозволити LimeSurvey підключатися до вашого облікового запису Gmail, вам потрібно буде дозволити менш безпечним застосункам використовувати ваш обліковий запис.
Заповніть поля. Виберіть потрібні налаштування сервера та шифрування. Після завершення натисніть кнопку Зберегти у верхній правій частині екрана.
5. Тепер ви можете натиснути кнопку Розпочати обробку баунсу:
Система відстеження недоставлених листів почне шукати survey-id, token-id та сповіщення про доставку, які додані до заголовка кожного повернутого листа. Якщо ці користувацькі заголовки існують, система змінить колір шрифту неправильних електронних адрес у таблиці учасників опитування на червоний. Також статус листа відповідних записів буде змінено з OK на bounced.
