Introduction

Our email service is a connector to SMTP-based email server and SendGrid email service. It supports sending out emails with a plain text body or attachment in a business scenario like policy issuance. The manual and restful APIs are provided for user.

Usage Scenarios

Email service is designed to help digital marketers and application developers send marketing, notifications, and business emails. It is a reliable, economical, and practical service for enterprises of all sizes that contact customers with email. The user can configure their own email account before using the service.

Apply for an email sender

If you need to apply for an email sender of your own domain with aws ses, the following table shows the information you need to fill in.

Basic UI Operations

Entrance

1. Log in to insureMO Portal with your personal account.

2. Click Catalog at the top of the home page.

3. In the left panel of the Catalog page, navigate to Non Insurance Services > Communications.

4. Find EMail Service card. You will see API Details and Settings.
   
   a. API Details will give you direct access to the APIs listed in it.
   
   b. For creation and other actions, you need to click Setting to go to the Email Management page.
   
   c. This will navigate to the main email settings page where you can manage the service.
   

Account Management

Create

• Click Create on the email service console.

• Register your email account. Click Submit. It will be saved and appear in the list in the main page.

Edit

• Click Edit on the email service console.

Delete

• Click Delete against a particular record to delete the account.

Share

• Click Share to share the current configuration of email account operator with other tenants.

Test

• After the account is created successfully, you can verify whether the current account is available through a test email. If available, the receiver will receive the following test email.

Blacklist Management

• If there is a recipient in the blacklist, the email address of the recipient will be invalid, and all accounts in the mail service cannot send email to the recipient.

Create

• Click Create on the Blacklist management page.

Delete

• Click Delete to remove the email address from the blacklist.

Template Management

• Configure the email content Template to automatically send notifications.

Create

• Click Create on the Template management page.

Log

• You can view the log files in the Audit Service, they are available for a particular day and can be downloaded as well. This is required for audit purpose and to check if there is any issue in the service.

Developing with Email Service

Send Email

Calling REST APIs

For all API list, see insureMO API Reference - email.

After the mail account is configured by the tenant, the tenant can call the API to send emails.

Authentication

HTTP Authentication, scheme: bearer

POST SendEmail

• Header

Body Parameters

{
  "account_name": "insuremo@insuremo.com",
  "alias": "insureMO",
  "attachments": [
    {
      "content": "string",
      "content_id": "string",
      "headers": {
        "property1": "string",
        "property2": "string"
      },
      "mime_type": "string"
    }
  ],
  "auto_format_html": false,
  "bcc": [
    "sample@insuremo.com"
  ],
  "cc": [
    "sample@insuremo.com"
  ],
  "content": "string",
  "content_type": "text/html",
  "custom_headers": {
    "property1": "string",
    "property2": "string"
  },
  "priority": false,
  "reply_to": "string",
  "sender_params": {
    "property1": "string",
    "property2": "string"
  },
  "subject": "Email Service Testing Email",
  "template_code": "string",
  "template_params": {
    "property1": "string",
    "property2": "string"
  },
  "to": [
    "sample@insuremo.com"
  ]
}

Response Examples

If the code is “i_common_success”, it indicates successful sending. Otherwise, the sending fails.

{
  "code": "i_common_success",
  "data": {
    "content_length": 0,
    "data": "string",
    "message_id": "string"
  },
  "message": "string",
  "message_params": [
    "string"
  ],
  "trace_id": "string"
}

Using insureMO Email SDK For Java

Please refer to this document: Welcome to insureMO SDK for Java.

Code example:

import com.insuremo.sdk.core.exception.ApiException;
import com.insuremo.sdk.services.sns.SnsSdkClient;
import com.insuremo.sdk.services.sns.api.EmailApi;
import com.insuremo.sdk.services.sns.bundle.SendEmailResponseBundle;
import com.insuremo.sdk.services.sns.model.SendEmailRequest;

public class EmailApi_sendEmail {

    public static void main(SnsSdkClient snsSdkClient) {
        System.out.println("----- Example for EmailApi.sendEmail -----");
        EmailApi emailApi = snsSdkClient.emailApi();

        System.out.println("----- sendEmail -----");

        try {
            SendEmailResponseBundle responseBundle = emailApi.newSendEmailRequestBuilder()
                    .sendEmailRequest(new SendEmailRequest().
                            accountName("portal-test@insuremo.com").
                            subject("email testing").
                            content("This is a testing email").
                            addToItem("sdk-test@simulator.insuremo.com"))
                    .doRequest();
            System.out.println(responseBundle.getBody().getData());
        } catch (ApiException e) {
            System.out.println(e.getResponseBody());
            System.out.println(e.getCode());
        }
        System.out.println("----- Done. -----");
    }
}

Send 2FA Email (Verify Code)

Please see Send An MFA Code via Email.

Migrate to SNS API

Send Email

API:

https://[host]/eBao/1.0/email/send

=>

https://[host]/mo-fo/1.0/sns/email/send

Request Body:

Response:

/eBao/1.0/email/send

Success Response:

HTTP Status Code: 200

{
    "body": "abcd1234-ab12-cd34-ac13-abcd1234abcd",
    "info": "abcd1234-ab12-cd34-ac13-abcd1234abcd",
    "status": 0
}

Failed Response:

HTTP Status Code: 200

{
    "body": null,
    "info": "error message",
    "message": "error message",
    "status": 1
}

=>

/mo-fo/1.0/sns/email/send

Success Response:

HTTP Status Code: 200

{
  "code": "i_common_success",
  "data": {
    "content_length": 0,
    "data": "string",
    "message_id": "string"
  },
  "trace_id": "string"
}

Failed Response:

HTTP Status Code: 499 / 599

{
  "code": "e_sns_email_error_code",
  "message": "string",
  "message_params": [
    "string"
  ],
  "trace_id": "string"
}

FAQs

Q: What email can I send?

A: Triggered email: Emails triggered by events, such as registration notification, transaction notification, and verification notification emails.

Batch email: Subscription emails sent to members, such as product promotion, user notification, periodical information. The email service only allows sending commercial emails permitted by the recipient. The mail content is the recipient’s active subscription. The unlicensed spam is not allowed to be sent.

Q: Can the attachments be added to email?

A: Yes, see API interface for more details.

Q: Why did all the emails go into the recipient’s junk mailbox?

A: It’s generally because the email content is judged as spam by the recipient’s system. Attempts can be made to adjust the email content and avoid the use of spam terms. Then send a test email to your other mailboxes to check if the new content is still considered as spam.

Q: Suggestions on Spam Handling

A: Standardize the email content and use the link address of website. Avoid using short link address. Otherwise, it will be regarded as spam.

Add the address of the unsubscribe link to the email content and perform the actual unsubscribe. At the same time, remind the recipient to add the sender’s address to the whitelist or to contact at a clear location. At the same time, add the introduction of your company and products.

If the sender sends the same message to multiple recipients at the same time, it may also be automatically identified as spam by the system.