Mailing list

Available in Classic and VPC

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

Mailing list interface

Navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL > Mailing list in the NAVER Cloud Platform console to access the Mailing list menu.
The Mailing list interface includes the following components:

View mail list

MAIL provides lists of requested mail based on various criteria for greater convenience.
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 mail sent in a single request.

List by request

To view a list by request:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL.
2. Click the Mailing list menu.
3. Select or enter the desired search conditions in the search bar and click [Search].
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 the mail send was 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 if a mail template is used.
   • Template name: Name of the template 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 [View list by mail] 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:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL.
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 [Search].
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 if a mail template is used.
     • Template name: Name of the template if a mail template is used.
   • Recipient information
     • Address: Recipient's address.
     • Receipt status: Whether or not the recipient received the mail.
     • Unsubscribed status: Whether the recipient has requested to unsubscribe.
     • Delivery result code: System-recorded delivery result code. For more information, see Delivery 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: Mail subject.
     • Content: Mail content. Click [View content] to check.
     • Attachment: Attached files of the mail.

Delivery result code

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

List by mail

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

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL.
2. Click the Mailing list menu.
3. Select or enter the desired search conditions in the [List by request] tab and click [Search].
4. Click the number of recipients for the desired item, or click [View list by mail] in details.
5. On the List by mail interface, select or enter the desired search conditions in the search bar and click [Search].
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 [Cancel scheduled send] 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 if a mail template is used.
     • Template name: Name of the template if a mail template is used.
     • Request IP: IP from which the mail send is requested.
   • Recipient information
     • Address: Recipient's address.
     • Receipt status: Whether or not the recipient received the mail.
     • Receipt date and time: Date and time the recipient received the mail.
     • Delivery result code: System-recorded delivery result code. For more information, see Delivery result code.
   • Email content
     • Subject: Mail subject.
     • Content: Mail content. Click [View content] to check.
     • Attachment: Attached files of the mail.

Download mail list

To download the mail list data being viewed as an Excel file:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL.
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 [Download request/list].
5. In the Excel download list popup window, click [Request file creation].
   • Depending on the data size, it may take some time to generate the file.
   • The generated file can be downloaded for 1 week before it expires.
6. Click [Download].
   • The data is downloaded to your local PC.
7. Click [OK].

Send mail

To send regular or advertisement mails:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Simple & Easy Notification Service > MAIL.
2. Click the Mailing list menu.
3. Click [Send].
4. When the mail sending interface appears, choose whether to use a template.
   • If Use template is enabled, select the desired template from the drop-down list or click [Load].
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 [Precautions for sending] 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 ${tag name} format, you can enter the tag values after composing the mail.
7. To attach files, drag and drop files into the Attachment component or click [Add file] 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 mail individually to multiple recipients. Up to 1,000 To addresses can be entered. Multiple addresses can be entered after clicking [Bulk entry], separated by the [Tab]/[Space]/[Enter] key or a semicolon (;).
   General	Send as general mail in which recipients are displayed. The General type cannot be selected for advertisement mail. Metadata tags cannot be used. Up to 1,000 To addresses can be entered. Up to 30 Cc addresses can be entered. Up to 30 Bcc addresses can be entered. Multiple addresses can be entered after clicking [Bulk entry], separated by the [Tab]/[Space]/[Enter] key or a semicolon (;).
   Send bulk mails via file upload	Send mail to more than 1,000 recipients or send personalized mail for each recipient using user substitution tags. Click [Download input template for sending to bulk recipients] to download the Excel template. Enter recipient addresses (up to 100,000) and substitution tag values in the downloaded file and save it. Click [Select file for bulk send] to upload the template file.
   Send group combined bulk mails	Send mail using registered recipient groups without a limit on the number of recipients. Click [Select group] to select multiple groups. Select the Combination filter method. AND: Only addresses included in all selected groups are set as recipients. OR: All addresses included in any of the selected groups are set as recipients. [Request/list combination result download]: Download the list with the combination filter applied to check recipients.

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 [Send].
    • If you wish to review the mail content before sending, click [Review and send]. 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 [OK].

Using substitution tags

You can send personalized content by using substitution tags in the mail subject and body. Substitution tags can be divided into user-defined substitution tags and metadata tags, and the descriptions 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:

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 [Send] or [Review and send].
4. Enter the tag values in the substitution tag value input popup window and click [OK].

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":"Event ${SEQ} notification",
  "body":"Hello #{RECIPIENT_NAME}! We are holding customer 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: Sender's address. The value that will be automatically populated at the #{SENDER_ADDRESS} location.
• senderName: 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: 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: Recipient's email address. The value that will be automatically populated at the #{RECIPIENT_ADDRESS} location.
  • name: Recipient's name. The value that will be automatically populated at the #{RECIPIENT_NAME} location.
  • type: 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:

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 [Download input template for sending to bulk recipients] to download the Excel template.
4. Enter the recipient addresses and substitution tag values in the template file, then save the file.
5. Click [Select file for bulk send] to upload the template file.
6. Click [Send] or [Review and send].

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: Sender's address. The value that will be automatically populated at the #{SENDER_ADDRESS} location.
• senderName: 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: Mail content. Contains the metadata tags like the unsubscribe link, and user-defined substitution tags ${BEFORE_GRADE} and ${AFTER_GRADE}.
• recipients: A list containing one or more recipients.
  • address: Recipient's email address. The value that will be automatically populated at the #{RECIPIENT_ADDRESS} location.
  • name: Recipient's name. The value that will be automatically populated at the #{RECIPIENT_NAME} location.
  • type: 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: 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.

Manage mail

On the Mailing list interface, you can perform the following additional management tasks on the [List by request] tab.

• Immediately send mail ready to be sent
• Cancel sending

Immediately send mail ready to be sent

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

1. In the Mailing list interface, search for ready to send mails on the [List by request] tab.
   
2. Click [Send immediately] for the mail you want to send immediately.
3. Click [OK] 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: MAIL is saving the delivery 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 delivery request information saved in MAIL 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:

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