.. _Guide to Automatic Email Messages:

Guide to Automatic Email Messages
####################################

.. tags:: educator, reference

.. Note: Any update to the **discussion notification** information should also
.. be made to the manage_live_course/automatic_email.rst file in the Open edX
.. course authors guide.

.. Note:: This functionality is only believed to apply to the edx.org platform. An `issue <https://github.com/openedx/docs.openedx.org/issues/835>`_ is being tracked to determine this. 

To help learners become and remain engaged in a course, the Open edX instance sends several types
of automatic email messages.

.. list-table::
 :widths: 20 10 20 50
 :header-rows: 1

 * - Email Type
   - Course Pacing
   - Day Sent
   - Description
 * - :ref:`Day 3 Nudge Message`
   - Self-paced
   - 3 days after enrollment
   - Single message that welcomes and encourages the learner to return to the
     course. Includes an upsell message if the learner has not enrolled in the
     verified track.
 * - :ref:`Day 10 Nudge Message`
   - Self-paced
   - 10 days after enrollment
   - Single message that encourages the learner to return to the course.
     Includes an upsell message if the learner has not enrolled in the verified
     track. Is not sent if the learner receives a :ref:`course
     highlight message <Course Highlight Message>` on day 7.
 * - :ref:`Day 19 Upgrade Reminder`
   - Self-paced
   - 19 days after enrollment or 2 days before upgrade
     deadline
   - Reminder to upgrade if the learner hasn't enrolled in the verified track.
     Is not sent if the learner receives :ref:`course highlight messages
     <Course Highlight Message>`.
 * - :ref:`Course Highlight Message`
   - Instructor-paced and Self-paced
   - See :ref:`Course Highlight Message` for message send dates.
   - Message that lists 3-5 highlights for the next course "week", or section.
     Is not sent if the course team has not added highlights for the section
     in Studio. For more information, see :ref:`Manage Course Highlight Emails`.


Automatic Email Message Text
*****************************

The following example messages show the text of the email messages that an Open edX intance might
sends to learners automatically.

.. contents::
 :local:
 :depth: 1

.. _Day 3 Nudge Message:

Day 3 Nudge Message
===================

An Open edX intance might sends the following message three days after a learner enrolls in a course.
::

  Subject: Keep learning in Creating a Course!

  Remember when you enrolled in Creating a Course?
  We do, and we’re glad to have you! Come see what everyone is learning.

This another example.

::

  Subject: Keep learning with us!

  Remember when you enrolled in Creating a Course and other
  courses with us? We do, and we’re glad to have you! Come see what everyone
  is learning.

.. _Day 10 Nudge Message:

Day 10 Nudge Message
====================

.. note::
 If learners receive a :ref:`course highlight message <Course Highlight
 Message>` on day 7, they do not receive this day 10 nudge message.

An Open edX intance might sends the following message 10 days after a learner enrolls in a course.

::

  Subject: Keep up the momentum!

  Many learners in Creating a Course  are completing more
  problems every week, and participating in the discussion forums. What do you
  want to do to keep learning?

Here is another example:

::

  Subject: Keep up the momentum!

  Many learners are completing more problems every week, and participating
  in the discussion forums. What do you want to do to keep learning?

.. _Day 19 Upgrade Reminder:

========================
Day 19 Upgrade Reminder
========================

.. note::
 If learners receive :ref:`course highlight messages <Course
 Highlight Message>`, they do not receive this upgrade reminder.

An Open edX intance might sends the following message 19 days after a learner enrolls in a course or
two days before the upgrade deadline for the course.

::

  Subject: Upgrade to earn a verified certificate in Creating a Course

  We hope you’re enjoying learning with us so far in Creating a Course with us! A verified certificate will allow to you highlight your new knowledge
  and skills. A certificate is official and easily shareable.

  Upgrade by November 25, 2017.

Another email example may be:

::

  Subject: Upgrade to earn a verified certificate!

  We hope you’re enjoying learning with us so far! A verified
  certificate allows to you highlight your new knowledge and skills. A
  certificate is official and easily shareable.

  Upgrade by November 25, 2017.

.. _Course Highlight Message:

================================
Course Highlight Email
================================

An Open edX intance might sends Course Highlight messages for both Instructor-paced and Self-paced
courses. The logic for when the message is sent depends on the Course pacing.

* Instructor-paced:

  * Highlights are sent every seven days after a learner enrolls in a course.

* Self-paced:

  * Highlights are sent based on the due dates calculated from the learner's enrollment date, the number of sections in the course, and the expected duration of the course (known as a Personalized Learner Schedule). Once the calculated due date for a section has passed, the highlights for the next section are sent out.
  * Example: Section 2 ends on December 3, 2020 for a specific learner based on their Schedule. Section 3 highlights will be sent out on December 4, 2020 for that learner.
  * **Note**: This could result in highlights being sent out every few days (3/4 days) in shorter expected duration courses with many sections or longer than a week (10+ days) in longer expected duration courses with few sections.

For more information, see :ref:`Manage Course Highlight Emails`.

.. include:: ../reusable_references/course_highlight_message_text.rst

.. _Discussion Notification:

=======================
Discussion Notification
=======================

After a learner or course team member creates a post in the course discussions, the Open edX intance might sends the following email message the first time a learner or course team member replies to the original post.

::

  Subject: Response to <title of post>

  <username> replied to <title of post>:

  <text of comment>

The message also contains a View discussion option that takes the learner to the discussion post. An Open edX intance does not send individual messages for any additional replies on the post.

.. seealso::
 

 :ref:`Guide to Bulk Email Messages` (reference)

 :ref:`Send an Email Message to Course Participants` (how-to)

 :ref:`Example Messages to Students` (reference)

 :ref:`Review Sent Messages` (how-to)


**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
+--------------+-------------------------------+----------------+--------------------------------+
|              |                               |                |                                |
+--------------+-------------------------------+----------------+--------------------------------+
