Mailing list

Available in Classic and VPC

You can send mails and check the history of sent mails.

Mailing list screen

To access the Mailing list menu, on the NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer > Mailing list in order.
The Mailing list screen is laid out as follows:

View mail list

Cloud Outbound Mailer enhances user convenience by offering mail lists based on various criteria.
The provided lists are as follows:

• List by request: a list sorted by mail send request
• List by recipient: a list sorted by mail recipient
• List by mail: a list of mails sent in a single request

List by request

To view a list by request, follow these steps:

1. On NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer in order.
2. Click the Mailing list menu.
3. Select or enter the desired search conditions in the search bar and click the [Search] button.
4. When the mail list appears, view the summary information or click it to see more details.
   
   • Request ID: ID of the mail send request
   • Sender address: address entered as the mail sender
   • Request date and time: date and time the mail send was requested
   • Send date and time: date and time the mail was sent
   • Send duration: time taken to complete the mail send
   • Scheduled send status: immediate send or scheduled send status
   • Cancellation date and time: date and time of cancellation is sending mail is canceled
   • Request count: number of times the mail was split and sent. This can be less than the number of recipients if not sent individually
   • Send status: current sending status of the mail. For more information, see Send status
   • Sender name: name entered as the mail sender
   • Template ID: ID of the template used if a mail template is used
   • Template name: name of the template used if a mail template is used
   • Request IP: IP from which the mail send is requested
   • Send request tool: tool used to request the mail send. Displayed as CONSOLE or API
   • Advertisement mail status: indicates whether the mail is an advertisement or general mail
   • Recipient count: number of recipients for the send request. Click the [View list by mail] button to navigate to the list by mail

Send status

The descriptions of the sending statuses displayed in the list are as follows:

List by recipient

To view a list by recipient, follow these steps:

1. On NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer in order.
2. Click the Mailing list menu.
3. Click the [List by recipient] tab.
4. Select or enter the desired search conditions in the search bar and click the [Search] button.
5. When the mail list appears, view the summary information or click it to see more details.
   
   • Email sending details
     • Project ID: ID of the mail sending project
     • Request ID: ID of the mail send request
     • Request date and time: date and time the mail send was requested
     • Send date and time: date and time the mail was sent
     • Scheduled send date and time: date and time the mail is scheduled to be sent
     • Send status: current sending status of the mail. For more information, see Send status
     • Mail ID: ID of the mail requested to be sent
     • Template ID: ID of the template used if a mail template is used
     • Template name: name of the template used if a mail template is used
   • Recipient information
     • Address: mail recipient's address
     • Receipt status: whether the recipient received the mail
     • Unsubscribed status: whether the recipient has requested to unsubscribe
     • Send result code: system-recorded send result code. For more information, see Send result code
     • Resend count: number of times the mail was resent
     • Receipt date and time: date and time the recipient received the mail
     • Unsubscribed date and time: date and time the recipient has requested to unsubscribe
   • Email content
     • Subject: subject of the mail
     • Content: content of the mail. Click the [View content] button to check
     • Attachment: attached files of the mail

Send result code

The descriptions of the send result codes displayed in the list are as follows:

List by mail

In the list by request, click the number of recipients or click the [View list by mail] button in the details to view list by mail. To view a list by mail, follow these steps:

1. On NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer in order.
2. Click the Mailing list menu.
3. Select or enter the desired search conditions in the [List by request] tab and click the [Search] button.
4. Click the number of recipients for the desired item, or click the [View list by mail] button in details.
5. In the mail list screen, select or enter the desired search conditions in the search bar and click the [Search] button.
6. When the mail list appears, view the summary information or click it to see more details.
   
   • Email sending details
     • Project ID: ID of the mail sending project
     • Request ID: ID of the mail send request
     • Request date and time: date and time the mail send was requested
     • Send date and time: date and time the mail was sent
     • Scheduled send date and time: date and time the mail is scheduled to be sent. Click the [Cancel scheduled send] button to cancel the scheduled send
     • Send status: current sending status of the mail. For more information, see Send status
     • Mail ID: ID of the mail requested to be sent
     • Template ID: ID of the template used if a mail template is used
     • Template name: name of the template used if a mail template is used
     • Request IP: IP from which the mail send is requested
   • Recipient information
     • Address: mail recipient's address
     • Receipt status: whether the recipient received the mail
     • Receipt date and time: date and time the recipient received the mail
     • Send result code: system-recorded send result code. For more information, see Send result code
   • Email content
     • Subject: subject of the mail
     • Content: content of the mail. Click the [View content] button to check
     • Attachment: attached files of the mail

Download mail list

To download the mail list data being viewed as an Excel file, follow these steps:

1. On NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer in order.
2. Click the Mailing list menu.
3. After selecting a tab, select or enter the search conditions to view the desired list.
4. With the list displayed, click the [Download request/list] button.
5. In the Excel download list popup window, click the [Request file creation] button.
   • Depending on the data size, it may take some time to generate the file.
   • The generated file can be downloaded for one week before it expires.
6. Click the [Download] button.
   • The data is downloaded to your local PC.
7. Click [OK].

Send mail

To send regular or advertisement mails, follow these steps:

1. On NAVER Cloud Platform console, click > Services > Application Services > Cloud Outbound Mailer in order.

2. Click the Mailing list menu.

3. Click the [Send] button.

4. When the mail sending screen appears, choose whether to use a template.

   • If Use template is enabled, select the desired template from the drop-down list or click the [Load] button.

5. Select the type of mail in the Mail classification.

   • Regular mail: sent as a regular mail.
   • Advertisement mail: classified as an advertisement mail with an advertisement label added to the subject, and the option to set an unsubscribe notice. Click the [Precautions for sending] button for more information on advertisement mails.

6. Enter the sender's name, sender's mail address, and mail subject.

   • When using a template, these fields are automatically populated. To edit these fields, disable the Use template after loading it.
   • If the mail subject contains substitution tags in the format ${tag name}, you can enter tag values after composing the mail.

7. To attach files, drag and drop files into the Attachment area or click the [Add file] button to select files.

   • Attachment size: up to 10 MB per file, total 20 MB (including image files in the mail body)
   • File extensions that cannot be attached: bat, cmd, com, cpl, exe, scr, js, vbs, ocx, pif, msi, efi, fon, drv, dll, sys, app, dmg, ipa, apk, jar, wsh, reg, hlp, lnk, wsf, scf, swf, cab
   • Attaching a zip file (zip, rar) containing unsupported files may cause the mail sending to fail.

8. Compose the mail content.

   • You can select between Editor, HTML, TEXT styles for composing the mail.
   • When using a template, these fields are automatically populated. To edit these fields, disable the Use template after loading it.

9. In the Bulk send classification, select the sending type and enter recipient information.

   Type	Description
   Send individually	Send mails individually to multiple recipients Enter up to 1000 recipient addresses You can click the [Bulk input] button to input multiple addresses, and separate them using the [Tab]/[Space]/[Enter] keys or a semicolon (;)
   General	Send as a regular mail where recipients' addresses are visible Advertisement mails cannot be sent as regular type Metadata tags cannot be used Enter up to 1000 recipient addresses Enter up to 30 CC addresses Enter up to 30 BCC addresses You can click the [Bulk input] button to input multiple addresses, and separate them using the [Tab]/[Space]/[Enter] keys or a semicolon (;)
   Send bulk mails via file upload	Send mails to more than 1000 recipients or to send personalized mails using user substitution tags Click the [Download input template for sending to bulk recipients] button to download an Excel template Enter recipient addresses (up to 100,000) and substitution tag values in the downloaded file and save it Click the [Select file for bulk send] button to upload the template
   Send group combined bulk mails	Send mails using registered recipient groups without any recipient limit Click the [Select group] button to select multiple groups Choose a Combination filter method AND: only addresses common to all selected groups will be set as recipients OR: all addresses included in any of the selected groups will be set as recipients [Request/Download combined results]: download and view the list of recipients after the combination filter is applied

10. To schedule a send, click the Scheduled send checkbox and select the date and time for sending.

    • The mail will appear in the mailing list with a status of Ready to send, allowing you to cancel or send it immediately.
    • The scheduled send date can be set up to 30 days from the current date.

11. Click the [Send] button.

    • If you wish to review the mail content before sending, click the [Review and send] button. The mail will appear in the mailing list with a status of Ready to send, allowing you to cancel or send it immediately.

12. If the mail subject and content include substitution tags, enter the tag values in the substitution tag value input popup window and click the [OK] button.

Using substitution tags

You can send personalized content by using substitution tags in the mail subject and body. Substitution tags can be divided to user-defined substitution tags and metadata tags, and the description of each tag are as follows:

Example 1: applying common user-defined substitution tag values to all recipients

An example of applying common user-defined substitution tag values to all recipients is provided below.

Applying in the console

To apply in the console, follow these steps:

1. Enter substitution tags in the mail subject or content.
2. Select Send individually or Send group combined bulk mails in the bulk sending classification and specify the recipients.
3. Click the [Send] or [Review and send] button.
4. Enter the tag values in the substitution tag value input popup window and click the [OK] button.

Applying via API

To apply via API, enter the following JSON code in the requestBody when requesting to send a mail.

{
  "senderAddress":"no_reply@company.com",
  "senderName":"administrator",
  "title":"Notification for event ${SEQ}.",
  "body":"Hello #{RECIPIENT_NAME}! Conducting a custom appreciation event ${SEQ}. <br/> <a href='#{UNSUBSCRIBE_URL}' target='_blank'>Unsubscribe</a>",
  "parameters":{
     "SEQ":"3"
  },
  "recipients":[
    {
      "address":"hongildong@naver_.com",
      "name":"Hong Gil Dong",
      "type":"R"
    },
    {
      "address":"chulsoo@daum_.net",
      "name":"Kim Chul Soo",
      "type":"R"
    }
  ],
  "individual":true
}

In the above code, the user-defined substitution tag values entered in the mail subject and content are applied uniformly to all recipients, while metadata tag values are personalized, resulting in different content for each recipient. The properties included in the code are as follows:

• senderAddress: the sender's address. The value that will be automatically populated at the #{SENDER_ADDRESS} location
• senderName: the sender's name. The value that will be automatically populated at the #{SENDER_NAME} location
• title: mail subject. Contains user-defined substitution tag ${SEQ}
• body: the mail content. Contains the recipient's name, metadata tags like the unsubscribe link, and user-defined substitution tag ${SEQ}
• parameters: substitution parameters that will be applied to all recipients. A JSON object where the key is the substitution tag, and the value is the corresponding tag value
• recipients: a list containing one or more recipients
  • address: the recipient's email address. The value that will be automatically populated at the #{RECIPIENT_ADDRESS} location
  • name: the recipient's name. The value that will be automatically populated at the #{RECIPIENT_NAME} location
  • type: the recipient type. If individual value is true, "R"(Recipient) can be specified, and if individual value is false, "R"(Recipient), "C"(CC), and "B"(BCC) can be specified
• individual: whether to send individually. If the value is true, CC and BCC are ignored, and mails are sent individually to multiple recipients

Example 2: applying unique user-defined substitution tag values to each recipient

An example of applying unique user-defined substitution tag values to each recipient is provided below.

Applying in the console

To apply in the console, follow these steps:

1. Enter substitution tags in the mail subject or content.
2. Select Send bulk mails via file upload in the bulk send classification.
3. Click the [Download input template for sending to bulk recipients] button to download the Excel template.
4. Enter the recipient addresses and substitution tag values in the template file, then save the file.
5. Click the [Select file for bulk send] button to upload the template file.
6. Click the [Send] or [Review and send] button.

Applying via API

To apply via API, enter the following JSON code in the requestBody when requesting to send a mail.

{
  "senderAddress":"no_reply@company.com",
  "senderName":"administrator",
  "title":"Hello, #{RECIPIENT_NAME}. We are notifying you of a change in your grade.",
  "body":"Your grade has been changed from ${BEFORE_GRADE} to ${AFTER_GRADE}. <br/> <a href='#{UNSUBSCRIBE_URL}' target='_blank'>Unsubscribe</a>",
  "recipients":[
    {
      "address":"hongildong@naver_.com",
      "name":"Hong Gil Dong",
      "type":"R",
      "parameters":{
        "BEFORE_GRADE":"SILVER",
        "AFTER_GRADE":"GOLD"
      }
    },
    {
      "address":"chulsoo@daum_.net",
      "name":"Kim Chul Soo",
      "type":"R",
      "parameters":{
        "BEFORE_GRADE":"BRONZE",
        "AFTER_GRADE":"SILVER"
      }
    }
  ],
  "individual":true
}

In the above code, the metadata tag values in the subject are personalized for each recipient, while the user-defined substitution tag values in the content are also personalized and applied differently for each recipient. The properties included in the code are as follows:

• senderAddress: the sender's address. The value that will be automatically populated at the #{SENDER_ADDRESS} location
• senderName: the sender's name. The value that will be automatically populated at the #{SENDER_NAME} location
• title: mail subject. Contains the recipient's name as a metadata tag
• body: the mail content. Contains the metadata tags like the unsubscribe link, and user-defined substitution tag ${BEFORE_GRADE}, ${AFTER_GRADE}
• recipients: a list containing one or more recipients
  • address: the recipient's email address. The value that will be automatically populated at the #{RECIPIENT_ADDRESS} location
  • name: the recipient's name. The value that will be automatically populated at the #{RECIPIENT_NAME} location
  • type: the recipient type. If individual value is true, "R"(Recipient) can be specified, and if individual value is false, "R"(Recipient), "C"(CC), and "B"(BCC) can be specified
  • parameters: the substitution parameters that will be applied for each recipient. A JSON object where the key is the substitution tag, and the value is the corresponding tag value
• individual: whether to send individually. If the value is true, CC and BCC are ignored, and mails are sent individually to multiple recipients

Managing mails

In the Mailing list screen, you can perform below additional management tasks from the [List by request] tab.

• Immediately send ready to send mails
• Cancel sending

Immediately send ready to send mails

You can send Ready to send mails immediately by processing them as scheduled send or after confirmation. To send immediately, follow these steps:

1. In the Mailing list screen, search for ready to send mails in the [List by request] tab.
   
2. Click the [Send immediately] button for the mail you want to send immediately.
3. Click the [OK] button in the confirmation popup window.

Cancel sending

You can cancel the sending of mails that are in the statuses of Preparing to send, Ready to send, or Sending. The cancellation process operates differently as follows depending on the status.

• Preparing to send: the Cloud Outbound Mailer is currently saving the send request information. When canceled, only the information already saved will be changed to the canceled status, and any unsaved information will not be saved.
• Ready to send: the send request information saved in the Cloud Outbound Mailer is changed to the canceled status.
• Sending: since the mail is in the process of being sent, mails already sent will retain their sent status, while those not yet sent will be changed to the canceled status.

To cancel sending, follow these steps:

1. In the Mailing list screen, search for mails in the [List by request] tab that are in the statuses of Preparing to send, Ready to send, or Sending.
2. Click the [Cancel send] button for the mail you wish to cancel.
3. Click the [OK] button in the confirmation popup window.
   • The mail status will change to Send canceled.