docs: Clarify that a Segment Email's publish up date is optional for scheduled broadcasts - #836
promptless-for-oss wants to merge 2 commits into
Conversation
A published Segment Email with no publish up date is now broadcast immediately, matching how it's shown as active in the UI. The cron docs previously stated a publish up date was required, which is no longer true. Refs mautic/mautic#16493, mautic/mautic#16165
| Starting with Mautic 2.2.0, it's now possible to use cron to send scheduled broadcasts for Channel communications. The current only implementation of this is for Segment Emails. Instead of requiring a manual send and wait with the browser window open while AJAX batches over the send, it's possible to use a command to initiate the process. | ||
|
|
||
| The caveat for this is that the Email must have a published up date and be currently published - this is to help prevent any unintentional Email broadcasts. Just as it was with the manual/AJAX process the message is only sent to Contacts who haven't already received the specific communication. This command sends messages to Contacts added to the source Segments later, so if you don't want this to happen, set an unpublish date. | ||
| The Email must be active for Mautic to broadcast it. The 'Publish at (date/time)' field is optional and acts as a scheduled start date. If you leave it empty, Mautic broadcasts the Email as soon as you turn it on. If you set a future date, Mautic holds the Email back until that date and time. Mautic never broadcasts inactive Emails, which helps prevent unintentional Email broadcasts. Just as with the manual or AJAX process, Mautic only sends the message to Contacts who haven't already received the specific communication. This command sends messages to Contacts added to the source Segments later, so if you don't want this to happen, set an 'Unpublish at (date/time)' date. |
There was a problem hiding this comment.
PR #16493 changes EmailRepository::getPublishedBroadcastsQuery() to allow a null publish up date, so a published Segment Email with no publish up date is now broadcast immediately (a future date still holds it back). This makes the prior doc statement that the Email "must have a published up date" incorrect, so I rewrote the paragraph to describe the publish up date as an optional scheduled start date.
Source: mautic/mautic#16493
|
@promptless-for-oss please rebase to 7.3 branch. |
|
In reply to this discussion On it — I'll retarget this PR to the 7.3 branch and follow up once it's done. |
|
In reply to this discussion Done — I've retargeted this PR to the 7.3 branch. Since 7.2 and 7.3 currently point to the same commit, this was a clean base change with no rebase of history and no content changes. The PR is still mergeable. Thanks! |
2 participants
Open this suggestion in Promptless to view citations and reasoning process
Corrects the 'Send scheduled broadcasts' cron job section, which stated a Segment Email must have a publish up date to be broadcast. After the optional-start-date change, a published Segment Email with no publish up date is broadcast immediately; a future publish up date holds it back; inactive Emails are never sent. Aligns docs with mautic/mautic#16493 (fixes #16165).
Trigger Events
Tip: Configure how Promptless handles changelogs in Agent Settings 📋