- Print
- PDF
Mailing list
- Print
- PDF
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:
Area | Description |
---|---|
① Menu name | Name of the menu currently being viewed |
② Basic features | Features displayed upon first entry to the Mailing list menu
|
③ List tab |
|
④ Search bar | Search the mail list by request date, send status, request ID, recipient address, sender address, mail subject, template, and send request tool |
⑤ List | View the list of sent mails categorized by the selected tab
|
⑥ Download request/list | Download 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: 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:
- On the NAVER Cloud Platform console, click Services > Application Services > Cloud Outbound Mailer in order.
- Click the Mailing list menu.
- Select or enter the desired search conditions in the search bar and click [Search].
- 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:
Status | Description |
---|---|
Preparing to send | Currently 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 send | Saved in the sent history and pending scheduled sending or confirmation before sending. Can be canceled or sent immediately |
Sending | Mail is being sent. Can be canceled, and if canceled, only the unsent mails will be stopped |
Successfully sent | All mails have been sent successfully. Some recipients may have unsubscribed |
Partially failed | Some 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 send | All mails failed to send. Some recipients may have unsubscribed |
Unsubscribe | All advertisement mails have been unsubscribed |
Cancel send | Sending has been canceled |
List by recipient
To view a list by recipient, follow these steps:
- On the NAVER Cloud Platform console, click Services > Application Services > Cloud Outbound Mailer in order.
- Click the Mailing list menu.
- Click the [List by recipient] tab.
- Select or enter the desired search conditions in the search bar and click [Search].
- 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
- Email sending details
Send result code
The descriptions of the send result codes displayed in the list are as follows:
Code | Description |
---|---|
CANCELED_MAIL | Cancel sending |
CONNECTION_ABNORMAL | Temporary sending failure due to abnormal connection |
CONTENT_HAS_TAG_FORM | Sending failed due to the presence of substitution tags in the mail content |
DKIM_FAIL | Sending failed due to DKIM error |
EMPTY_BODY_CONTENT | Sending failed due to system error preventing mail body from being set |
MAILBOX_ABNORMAL | Temporary sending failure due to abnormal recipient mailbox |
MAILBOX_ERROR | Sending failed due to recipient mailbox error |
MAIL_CONTENTS_ERROR | Sending failed due to mail content error |
MAIL_SENT | Sending successful |
MIME_MESSAGE_CREATE_FAIL | Sending failed due to system error preventing MIME message creation |
NETWORK_ABNORMAL | Temporary sending failure due to abnormal network conditions |
NETWORK_ERROR | Sending failed due to network error |
NONEXISTENT_DOMAIN_ADDRESS | Sending failed due to non-existent recipient domain |
RECEIVE_MAIL_SERVICE_ABNORMAL | Temporary sending failure due to abnormal recipient mail service |
RECEIVE_MAIL_SERVICE_ERROR | Sending failed due to recipient mail service error |
RECIPIENT_ADDRESS_ERROR | Sending failed due to recipient address error |
RESENDING_MAIL | Resending in progress |
RESEND_MAIL_FAIL | Sending failed due to exceeded resending attempts |
SECURITY_AND_POLICY_ABNORMAL | Temporary sending failure due to abnormal security and policy conditions |
SECURITY_AND_POLICY_ERROR | Sending failed due to security and policy error |
SEND_BLOCK_ADDRESS | Sending blocked due to request to a blocked recipient |
SMTP_ABNORMAL | Temporary sending failure due to abnormal SMTP with the recipient side |
SMTP_ERROR | Sending failed due to SMTP error with the recipient side |
TEST_MAIL_SEND | Test mail sending by the system |
UNDEFINED_ERROR | Sending failed due to undefined error |
UNKNOWN_CAUSE_FAIL | Sending failed due to unknown error inside or outside the system |
UNKNOWN_DOMAIN_ADDRESS | Sending failed due to request to an address with an unknown or blocked domain |
UNSUBSCRIBE_ADDRESS | Sending blocked due to request to an unsubscribed address |
UNSUPPORTED_ENCODING_ADDRESS | Sending failed due to unsupported recipient address encoding |
READ_TIMED_OUT | Sending failed due to no response from the receiving server |
CONNECTION_ERROR | Sending 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:
- On the NAVER Cloud Platform console, click Services > Application Services > Cloud Outbound Mailer in order.
- Click the Mailing list menu.
- Select or enter the desired search conditions in the [List by request] tab and click [Search].
- Click the number of recipients for the desired item, or click the [View list by mail] button in details.
- In the mail list screen, select or enter the desired search conditions in the search bar and click the [Search] button.
- 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
- Email sending details
Download mail list
To download the mail list data being viewed as an Excel file, follow these steps:
- On the NAVER Cloud Platform console, click Services > Application Services > Cloud Outbound Mailer in order.
- Click the Mailing list menu.
- After selecting a tab, select or enter the search conditions to view the desired list.
- With the list displayed, click the [Download request/list] button.
- 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.
- Click the [Download] button.
- The data will be downloaded to your local PC.
- Click the [OK] button.
Send mail
To send regular or advertisement mails, follow these steps:
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.
On the NAVER Cloud Platform console, click Services > Application Services > Cloud Outbound Mailer in order.
Click the Mailing list menu.
Click the [Send] button.
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.
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.
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.
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.
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.
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
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.
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.
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 tags | Metadata tags |
---|---|
${tag name} format | #{tag name} format |
The substitution values are entered by the user | Automatically substitute values via mail-specific metadata |
No limit on the number of entries or tag names | Use specified values only
|
All tag values must be entered by the user before sending mails | Tag 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 classification | Not 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.
To apply in the console, follow these steps:
- Enter substitution tags in the mail subject or content.
- Select Send individually or Send group combined bulk mails in the bulk sending classification and specify the recipients.
- Click the [Send] or [Review and send] button.
- Enter the tag values in the substitution tag value input popup window and click the [OK] button.
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}
locationsenderName
: the sender's name. The value that will be automatically populated at the#{SENDER_NAME}
locationtitle
: 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 valuerecipients
: a list containing one or more recipientsaddress
: the recipient's email address. The value that will be automatically populated at the#{RECIPIENT_ADDRESS}
locationname
: the recipient's name. The value that will be automatically populated at the#{RECIPIENT_NAME}
locationtype
: the recipient type. Ifindividual
value istrue
,"R"
(Recipient) can be specified, and ifindividual
value isfalse
,"R"
(Recipient),"C"
(CC), and"B"
(BCC) can be specified
individual
: whether to send individually. If the value istrue
, 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.
To apply in the console, follow these steps:
- Enter substitution tags in the mail subject or content.
- Select Send bulk mails via file upload in the bulk send classification.
- Click the [Download input template for sending to bulk recipients] button to download the Excel template.
- Enter the recipient addresses and substitution tag values in the template file, then save the file.
- Click the [Select file for bulk send] button to upload the template file.
- Click the [Send] or [Review and send] button.
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}
locationsenderName
: the sender's name. The value that will be automatically populated at the#{SENDER_NAME}
locationtitle
: mail subject. Contains the recipient's name as a metadata tagbody
: 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 recipientsaddress
: the recipient's email address. The value that will be automatically populated at the#{RECIPIENT_ADDRESS}
locationname
: the recipient's name. The value that will be automatically populated at the#{RECIPIENT_NAME}
locationtype
: the recipient type. Ifindividual
value istrue
,"R"
(Recipient) can be specified, and ifindividual
value isfalse
,"R"
(Recipient),"C"
(CC), and"B"
(BCC) can be specifiedparameters
: 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 istrue
, 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:
- 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.
- In the Mailing list screen, search for ready to send mails in the [List by request] tab.
- Click the [Send immediately] button for the mail you want to send immediately.
- 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.
Mails that have already been sent cannot be canceled.
To cancel sending, follow these steps:
- 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.
- Click the [Cancel send] button for the mail you wish to cancel.
- Click the [OK] button in the confirmation popup window.
- The mail status will change to Send canceled.