[Email_Status] returns the status of an email message that was sent using [Email_Send] or [Email_Queue]. The tag requires the unique ID of the email message which is returned using [Email_Result].
The tag will return a value of "queued", "error", or "sent". Lasso attempts to send messages multiple times if minor errors are encountered. A valid message will have a status of "queued" until the maximum number of retries is reached. Messages which are invalid or have reached their retry limit will have a status of "error". Messages which have been sent (or are not found in the queue) will have a status of "sent".
Note that [Email_Status] called immediately after queueing a message will almost always return "queued" since Lasso has not yet had a chance to send the message. It can take a few seconds on an idle server to send a message or longer on a busy server. This tag would typically be used by storing the unique ID returned by [Email_Result] in a database and then checking on the status of the message after a suitable delay.
[Email_Send: -To='example@example.com', -From='example@example.com', -Subject='Testing', -Body='Testing]
[Var: 'id' = (Email_Result)]
[Email_Status: $id]
See the Lasso 8 Language Guide for examples of how to use this tag.
Tag Link | [Email_Status] | Category | |
---|---|---|---|
Type | Substitution | Data Source | Any |
Support | Preferred | Version | 8.0.5 |
Output Type | String | Security | None |
Implementation | LDML | Sets | Lasso 8.5, Lasso 8.0 |
Please note that periodically LassoSoft will go through the notes and may incorporate information from them into the documentation. Any submission here gives LassoSoft a non-exclusive license and will be made available in various formats to the Lasso community.
©LassoSoft Inc 2015 | Web Development by Treefrog Inc | Privacy | Legal terms and Shipping | Contact LassoSoft