Mailing list
    • PDF

    Mailing list

    • PDF

    Article summary

    The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

    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:

    cloudoutboundmailer-use-mail_screen_ko

    AreaDescription
    ① Menu nameName of the menu currently being viewed
    ② Basic featuresFeatures displayed upon first entry to the Mailing list menu
    • [Send]: click to navigate to the mail sending screen (see Send mail)
    • [Learn more about the product]: click to navigate to the Cloud Outbound Mailer introduction page
    • [Refresh]: click to refresh the page
    ③ List tab
    ④ Search barSearch the mail list by request date, send status, request ID, recipient address, sender address, mail subject, template, and send request tool
    ⑤ ListView the list of sent mails categorized by the selected tab
    • click to the number of recipients to view the list by mail (see List by mail)
    Download request/listDownload the viewed mail list as an Excel file (see Download mail list)

    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

    To view a list by request, follow these steps:

    1. On the 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 [Search].
    4. When the mail list appears, view the summary information or click it to see more details.
      cloudoutboundmailer-use-mail_list_request_ko
      • 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:

    StatusDescription
    Preparing to sendCurrently being saved in the sent history. The number of recipients in the mail list by request and the mail list by recipient may differ if sending is canceled
    Ready to sendSaved in the sent history and pending scheduled sending or confirmation before sending. Can be canceled or sent immediately
    SendingMail is being sent. Can be canceled, and if canceled, only the unsent mails will be stopped
    Successfully sentAll mails have been sent successfully. Some recipients may have unsubscribed
    Partially failedSome mails failed to send. The sending status of each mail can be checked by clicking on the number of recipients to navigate to the list by mail
    Failed to sendAll mails failed to send. Some recipients may have unsubscribed
    UnsubscribeAll advertisement mails have been unsubscribed
    Cancel sendSending has been canceled

    List by recipient

    To view a list by recipient, follow these steps:

    1. On the 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 [Search].
    5. When the mail list appears, view the summary information or click it to see more details.
      cloudoutboundmailer-use-mail_list_recipient_ko
      • 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:

    CodeDescription
    CANCELED_MAILCancel sending
    CONNECTION_ABNORMALTemporary sending failure due to abnormal connection
    CONTENT_HAS_TAG_FORMSending failed due to the presence of substitution tags in the mail content
    DKIM_FAILSending failed due to DKIM error
    EMPTY_BODY_CONTENTSending failed due to system error preventing mail body from being set
    MAILBOX_ABNORMALTemporary sending failure due to abnormal recipient mailbox
    MAILBOX_ERRORSending failed due to recipient mailbox error
    MAIL_CONTENTS_ERRORSending failed due to mail content error
    MAIL_SENTSending successful
    MIME_MESSAGE_CREATE_FAILSending failed due to system error preventing MIME message creation
    NETWORK_ABNORMALTemporary sending failure due to abnormal network conditions
    NETWORK_ERRORSending failed due to network error
    NONEXISTENT_DOMAIN_ADDRESSSending failed due to non-existent recipient domain
    RECEIVE_MAIL_SERVICE_ABNORMALTemporary sending failure due to abnormal recipient mail service
    RECEIVE_MAIL_SERVICE_ERRORSending failed due to recipient mail service error
    RECIPIENT_ADDRESS_ERRORSending failed due to recipient address error
    RESENDING_MAILResending in progress
    RESEND_MAIL_FAILSending failed due to exceeded resending attempts
    SECURITY_AND_POLICY_ABNORMALTemporary sending failure due to abnormal security and policy conditions
    SECURITY_AND_POLICY_ERRORSending failed due to security and policy error
    SEND_BLOCK_ADDRESSSending blocked due to request to a blocked recipient
    SMTP_ABNORMALTemporary sending failure due to abnormal SMTP with the recipient side
    SMTP_ERRORSending failed due to SMTP error with the recipient side
    TEST_MAIL_SENDTest mail sending by the system
    UNDEFINED_ERRORSending failed due to undefined error
    UNKNOWN_CAUSE_FAILSending failed due to unknown error inside or outside the system
    UNKNOWN_DOMAIN_ADDRESSSending failed due to request to an address with an unknown or blocked domain
    UNSUBSCRIBE_ADDRESSSending blocked due to request to an unsubscribed address
    UNSUPPORTED_ENCODING_ADDRESSSending failed due to unsupported recipient address encoding
    READ_TIMED_OUTSending failed due to no response from the receiving server
    CONNECTION_ERRORSending failed due to the receiving server closing the connection

    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 the 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 [Search].
    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.
      cloudoutboundmailer-use-mail_list_mail_ko
      • 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 the 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 will be downloaded to your local PC.
    7. Click the [OK] button.

    Send mail

    To send regular or advertisement mails, follow these steps:

    Note

    You can pre-register recipients in groups in the address book or create mail templates in advance for more convenient mail sending.

    • For more information on how to register recipients in the address book, see Address book.
    • For more information on how to use mail templates, see Manage templates.
    1. On the 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 compressed 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.

      TypeDescription
      Send individuallySend 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 (;)
      GeneralSend 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 uploadSend 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 mailsSend 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 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:

    User-defined substitution tagsMetadata tags
    ${tag name} format#{tag name} format
    The substitution values are entered by the userAutomatically substitute values via mail-specific metadata
    No limit on the number of entries or tag namesUse specified values only
    • RECIPIENT_NAME: recipient's name
    • RECIPIENT_ADDRESS: recipient's mail address
    • SENDER_NAME: sender's name
    • SENDER_ADDRESS: sender's mail address
    • UNSUBSCRIBE_URL: unsubscribe link URL
    All tag values must be entered by the user before sending mailsTag values are automatically collected, substituted, and mailed (RECIPIENT_NAME, SENDER_NAME may not have a value specified, in which case it is substituted with an empty value)
    Available for all types of Bulk send classificationNot available when selecting the Bulk send classification as General

    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:

    Note
    • If you execute immediate sending for a scheduled mail, it will be sent at the current time instead of the scheduled time.
    • Mails registered as ready to send more than 30 days ago cannot be sent immediately.
    1. In the Mailing list screen, search for ready to send mails in the [List by request] tab.
      cloudoutboundmailer-use-mail_list_pending_ko
    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.
    Note

    Mails that have already been sent cannot be canceled.

    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.

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.