Email bounce tracking system - Revision history

C schmitz: Gave more details on Cloud bounce processing

2023-08-31T15:21:22Z

Gave more details on Cloud bounce processing

← Older revision		Revision as of 17:21, 31 August 2023
Line 117:		Line 117:

	<!--T:45-->		<!--T:45-->
	'''Bounces are automatically processed if you are using the LimeSurvey Cloud server. ~~There is no~~ need to set up anything and you ~~should~~ leave the default settings untouched.'''		'''Bounces are automatically processed if you are using the LimeSurvey Cloud server. You don't need to set up anything, and you don't need to start the bounce processing at all, just leave the default settings untouched. It all happens magically in the background.'''
			Please note that it might take 10-15 minutes until a bounced email is processed, and the related entry is marked.

	<!--T:46-->		<!--T:46-->
	{{Alert\|Attention\|text=Please don't abuse LimeSurvey for spam or we will have to lock your account. Make sure that you have the ~~general~~ consent of people you want to send invitations to.}}		{{Alert\|Attention\|text=Please don't abuse LimeSurvey Cloud for spam or we will have to lock your account. Make sure that you have the consent of people you want to send invitations to.}}

	==Starting Bounce Processing== <!--T:47-->		==Starting Bounce Processing== <!--T:47-->

C schmitz at 15:18, 31 August 2023

2023-08-31T15:18:14Z

← Older revision		Revision as of 17:18, 31 August 2023
Line 122:		Line 122:
	{{Alert\|Attention\|text=Please don't abuse LimeSurvey for spam or we will have to lock your account. Make sure that you have the general consent of people you want to send invitations to.}}		{{Alert\|Attention\|text=Please don't abuse LimeSurvey for spam or we will have to lock your account. Make sure that you have the general consent of people you want to send invitations to.}}

	==Starting Bounce Processing ~~in v3.0~~== <!--T:47-->		==Starting Bounce Processing== <!--T:47-->

	<!--T:48-->		<!--T:48-->
Line 145:		Line 145:
	<!--T:53-->		<!--T:53-->
	<center>[[File:Red bounced email addresses.png]]</center>		<center>[[File:Red bounced email addresses.png]]</center>


	== Starting Bounce Processing in v2.5 == <!--T:27-->		== Starting Bounce Processing in v2.5 == <!--T:27-->

C schmitz at 15:39, 16 December 2020

2020-12-16T15:39:15Z

← Older revision		Revision as of 17:39, 16 December 2020
Line 117:		Line 117:

	<!--T:45-->		<!--T:45-->
	Bounces are automatically processed if you are using the LimeSurvey Cloud server. There is no need to set up anything and you should leave the default settings untouched.		'''Bounces are automatically processed if you are using the LimeSurvey Cloud server. There is no need to set up anything and you should leave the default settings untouched.'''

	<!--T:46-->		<!--T:46-->

C schmitz at 15:38, 16 December 2020

2020-12-16T15:38:41Z

← Older revision		Revision as of 17:38, 16 December 2020
Line 110:		Line 110:


	===~~On using~~ LimeSurvey Cloud email server=== <!--T:43-->		===Using LimeSurvey Cloud email server=== <!--T:43-->

C schmitz at 15:31, 16 December 2020

2020-12-16T15:31:44Z

← Older revision		Revision as of 17:31, 16 December 2020
Line 110:		Line 110:


	===On using LimeSurvey ~~PRO~~ email server=== <!--T:43-->		===On using LimeSurvey Cloud email server=== <!--T:43-->


Line 117:		Line 117:

	<!--T:45-->		<!--T:45-->
	~~Even though this system can be easily~~ set up ~~(by leaving~~ the ~~bounce~~ settings ~~fields empty), it has one downside: if an email cannot be transmitted to the email receiver and bounces back, then you won't get any notifications whatsoever~~.		Bounces are automatically processed if you are using the LimeSurvey Cloud server. There is no need to set up anything and you should leave the default settings untouched.

	<!--T:46-->		<!--T:46-->

C schmitz: Text replacement - "LimeSurvey Professional" to "LimeSurvey Cloud"

2020-10-13T12:40:03Z

Text replacement - "LimeSurvey Professional" to "LimeSurvey Cloud"

← Older revision		Revision as of 14:40, 13 October 2020
Line 114:		Line 114:

	<!--T:44-->		<!--T:44-->
	If you are using the LimeSurvey ~~Professional~~ email server, all your emails will have the sender address "noreply@limesurvey.org". However, these emails will have a Reply-to header with your email address. So, in case someone tries to reply, they can write to you directly.		If you are using the LimeSurvey Cloud email server, all your emails will have the sender address "noreply@limesurvey.org". However, these emails will have a Reply-to header with your email address. So, in case someone tries to reply, they can write to you directly.

	<!--T:45-->		<!--T:45-->

Cdorin at 10:31, 6 August 2018

2018-08-06T10:31:36Z

← Older revision		Revision as of 12:31, 6 August 2018
Line 3:		Line 3:
	<!--T:1-->		<!--T:1-->
	__TOC__		__TOC__


	=Introduction= <!--T:2-->		=Introduction= <!--T:2-->


	<!--T:3-->		<!--T:3-->
Line 11:		Line 13:
	<!--T:34-->		<!--T:34-->
	{{Box\|Most email and hosting providers offer SMTP to send emails. The only thing for you to find out is the SMTP details that allow you to use that email address as a bounce email address.}}		{{Box\|Most email and hosting providers offer SMTP to send emails. The only thing for you to find out is the SMTP details that allow you to use that email address as a bounce email address.}}


	=Requirements= <!--T:4-->		=Requirements= <!--T:4-->


	<!--T:5-->		<!--T:5-->
Line 32:		Line 36:
	<!--T:8-->		<!--T:8-->
	If you don't have php5-imap installed and you have root access to the server, you can install it following the procedure specific to your distribution. For example, check [http://www.electrictoolbox.com/install-php-imap-debian/ this link] if you use Debian. Just remember to restart your web server once it is installed (e.g. run "apache/usr/sbin/apache2ctl restart" in terminal).		If you don't have php5-imap installed and you have root access to the server, you can install it following the procedure specific to your distribution. For example, check [http://www.electrictoolbox.com/install-php-imap-debian/ this link] if you use Debian. Just remember to restart your web server once it is installed (e.g. run "apache/usr/sbin/apache2ctl restart" in terminal).


	=How it works= <!--T:9-->		=How it works= <!--T:9-->


	<!--T:10-->		<!--T:10-->
Line 51:		Line 57:
	<!--T:14-->		<!--T:14-->
	When the email is bounced back, the original header along with the ''delivery notification header'' is received. The system then checks for new emails and parses the emails that have these custom headers. It changes the font color of the wrong email addresses from the [[Survey_participants\|survey participants table]] in red.		When the email is bounced back, the original header along with the ''delivery notification header'' is received. The system then checks for new emails and parses the emails that have these custom headers. It changes the font color of the wrong email addresses from the [[Survey_participants\|survey participants table]] in red.


	=Setting up the system= <!--T:15-->		=Setting up the system= <!--T:15-->


	<!--T:16-->		<!--T:16-->
Line 103:		Line 111:

	===On using LimeSurvey PRO email server=== <!--T:43-->		===On using LimeSurvey PRO email server=== <!--T:43-->


	<!--T:44-->		<!--T:44-->

Cdorin at 10:18, 6 August 2018

2018-08-06T10:18:59Z

← Older revision		Revision as of 12:18, 6 August 2018
Line 10:		Line 10:

	<!--T:34-->		<!--T:34-->
	{{Box\|Most email and hosting providers offer SMTP to send emails. The only thing for you to find out ~~are~~ the SMTP details that allow you to use that email address as a bounce email address.}}		{{Box\|Most email and hosting providers offer SMTP to send emails. The only thing for you to find out is the SMTP details that allow you to use that email address as a bounce email address.}}

	=Requirements= <!--T:4-->		=Requirements= <!--T:4-->
Line 72:		Line 72:

	<!--T:39-->		<!--T:39-->
	{{Box\|If your ~~host name~~ is 'smtp.server.net' and the port is 143, then write 'smtp.server.net:143' as ~~host name~~. For security reasons we currently only allow the following ports numbers: 110, 143, 587, 993 and 995.}}		{{Box\|If your hostname is 'smtp.server.net' and the port is 143, then write 'smtp.server.net:143' as hostname. For security reasons we currently only allow the following ports numbers: 110, 143, 587, 993 and 995.}}

	<!--T:40-->		<!--T:40-->
Line 105:		Line 105:

	<!--T:44-->		<!--T:44-->
	If you are using the LimeSurvey Professional email server, all your emails will have the sender address "noreply@limesurvey.org". However, these emails will have a Reply-to header with your email address. So, in case someone tries to reply, they can write you directly.		If you are using the LimeSurvey Professional email server, all your emails will have the sender address "noreply@limesurvey.org". However, these emails will have a Reply-to header with your email address. So, in case someone tries to reply, they can write to you directly.

	<!--T:45-->		<!--T:45-->
Line 208:		Line 208:

	<!--T:68-->		<!--T:68-->
	{{Alert\|Attention\|text=Gmail might treat the connection to your LimeSurvey account as an insecure one. To let LimeSurvey connect to your Gmail account, you [https://support.google.com/accounts/answer/6010255?hl=en will then need to allow less secure apps use your account].}}		{{Alert\|Attention\|text=Gmail might treat the connection to your LimeSurvey account as an insecure one. To let LimeSurvey connect to your Gmail account, you [https://support.google.com/accounts/answer/6010255?hl=en will then need to allow less secure apps to use your account].}}

	<!--T:69-->		<!--T:69-->
Line 223:		Line 223:

	<!--T:72-->		<!--T:72-->
	The email bounce tracking system will start to look for the survey-id, token-id, and delivery notification ~~that~~ are attached to the email header of each bounced email. If these custom headers exist, the system will change the font color of the wrong email addresses from the survey participants table in red. Also, the email status of the respective entries will be switched from ''OK'' to ''bounced''.		The email bounce tracking system will start to look for the survey-id, token-id, and delivery notification which are attached to the email header of each bounced email. If these custom headers exist, the system will change the font color of the wrong email addresses from the survey participants table in red. Also, the email status of the respective entries will be switched from ''OK'' to ''bounced''.

Cdorin at 11:45, 4 May 2018

2018-05-04T11:45:33Z

← Older revision		Revision as of 13:45, 4 May 2018
Line 7:		Line 7:

	<!--T:3-->		<!--T:3-->
	The email bounce tracking system ~~(available in v1.91 or later)~~ is capable of tracking down and marking the emails that were not delivered to the recipients (survey participants). The system relies on the "email delivery notification failure report". Therefore, it needs an email address where the emails can be sent to in order to track the bounces. Along with the address of the account, the credentials of the account are also required as well as the connection details.		The email bounce tracking system is capable of tracking down and marking the emails that were not delivered to the recipients (survey participants). The system relies on the "email delivery notification failure report". Therefore, it needs an email address where the emails can be sent to in order to track the bounces. Along with the address of the account, the credentials of the account are also required as well as the connection details.

	<!--T:34-->		<!--T:34-->

Han at 18:57, 7 February 2018

2018-02-07T18:57:26Z

← Older revision		Revision as of 20:57, 7 February 2018
Line 156:		Line 156:

	<!--T:32-->		<!--T:32-->
	''{{Alert\|title=Attention\|text=Some releases of v2.50+ do not correctly display this menu choice and the issue was fixed in build 160714 released on July 14, 2016.}}''		{{Alert\|title=Attention\|text=Some releases of v2.50+ do not correctly display this menu choice and the issue was fixed in build 160714 released on July 14, 2016.}}