Email List

Background

Some airlines block bookings which have emails from OTAs and travel companies as they want to promote their own sales channels. To overcome this blockage from airlines and to provide unique content to our customers, Atlas uses their own email service and changes the original email to an Atlas email when creating the booking with the airline.

The customer will not receive this email as the airline does not have the customer email id. Hence, Atlas has developed a feature whereby these emails can be viewed and actioned by the customer’s operations team members.

The “Email List” can be accessed with the below 3 methods:

  1. ATRIP

  2. Email List API

  3. Email Notification Webhook

Objective

The objective of having this list is that the customer can inform the passenger of any schedule changes or other important announcements made by the airline.

Email List Categories

The emails for the below categories will be displayed in the “Email List”:

  • Schedule change

  • Receipt

  • Payment Success

  • Verification

  • Trip Reminder

  • Promo code

  • Travel Itinerary

  • Advertisement

  • PNR Cancellation Success

  • Payment Due

  • Unidentified

  • Duplicated Schedule Change

  • Unaccounted Cancellation

ATRIP

All emails can be managed here, including flight changes, itineraries, etc. All emails sent by the airline to the contact email address will be displayed here, including advertisements.

The location of the email list is ATRIP --> Bookings --> Email List

Processing of the Email List

The email received in the email list can be “viewed”, “downloaded” and then “processed”.

Viewing the Email

Click on the “View” hyperlink. The email received from the airline will open in a new tab as shown below. The customer may then forward the email to the passenger as per their in-house process.

Downloading the Email

Click on the “Download” hyperlink. The email received from the airline will be downloaded on the laptop/PC. The customer may then forward the email to the passenger as per their in-house process.

Processing the Email

The emails can be processed in 2 ways:

  1. By clicking on “View” and then clicking on the “Handle” button.

  2. By clicking on one or more emails on the summary screen and then clicking on the “Batch Handle” button.

View” and click on the “Handle” button

Once the “View” hyperlink is clicked, the below screen will be displayed with the email in the browser.

Click on the “Handle” button on the top right of the screen

On clicking the “Handle” button, the below pop-up window will be displayed with the drop-down options.

Select the appropriate option and click ”Confirm”. When you check the Email List summary, the status would have changed to ”Processed”.

The options available are:

  • No Change (There is no change in the booking)

  • Flight Change Confirmed (There has been no flight change)

  • Micro Schedule Change (The schedule change is minimal)

  • API Notified (The customer has been notified via the email list API)

  • Wait (Customer will be informed later)

Batch Update

Select one or more emails from the email list. Then click on “Batch Handle” button.

A pop-up window will be displayed as shown below:

Select the appropriate option and click ”Confirm”. When you check the Email List summary, the status would have changed to ”Processed”.

Email List API

Endpoint: https://api-sg.atriptech.com/mail.do

Request

{

    "orderNo":null,

    "emailReceivingDateStart":"2023-11-01 00:00:00",

    "emailReceivingDateEnd":"2023-11-30 00:00:00",

    "createTimeStart":null,

    "createTimeEnd":null,

    "emailCategories": ["Travel Itinerary","Verification"],

    "pageIndex":1,

    "pageSize":100

}

orderNo

Optional

Order Number

emailReceivingDateStart

Optional

Receiving time Start.

emailReceivingDateEnd

Optional

Receiving time End.

You can only query data for up to one month at a time.

createTimeStart

Optional

Create time Start.

createTimeEnd

Optional

Create time End.

You can only query data for up to one month at a time.

emailCategory

Optional

Options:

  • Schedule change

  • Receipt

  • Payment Success

  • Verification

  • Trip Reminder

  • Promo code

  • Travel Itinerary

  • Advertisement

Multiple categories can be added, separated by a comma.

pageIndex

Required

Pagination

pageSize

Required

Number of records per page

maximum number=1000

Response

{

"records": [

{

"orderNo": "OPQRN20230520100137937",

"emailReceivingDate": "2023-11-02 07:29:28",

"uniqueCode": "d08a419d46bb93b8fd9e7ac3ea29a227",

"emailCategory": "Travel Itinerary",

"from": "[email protected]",

"to": "[email protected]",

"emailSubject": "Lion Group Reservation to PANGKALANBUUN, INDONESIA, November 02 for MS CATHERINE DEWOLFF",

"emailLink": "http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/11/d08a419d46bb93b8fd9e7ac3ea29a227.eml?Expires=1706010036&OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&Signature=9%2Bwzk6GcZRcnUIx8w5rbBHCirjI%3D",

"createTime": "2023-11-02 07:29:32"

},

{

"orderNo": "OPQRN20230520100137937",

"emailReceivingDate": "2023-11-02 07:31:06",

"uniqueCode": "4c5f214942b33659ad21d54366af32fa",

"emailCategory": "Travel Itinerary",

"from": "[email protected]",

"to": "[email protected]",

"emailSubject": "Lion Group Reservation to PANGKALANBUUN, INDONESIA, November 03 for MS CATHERINE DEWOLFF",

"emailLink": "http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/11/4c5f214942b33659ad21d54366af32fa.eml?Expires=1706010036&OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&Signature=RWgF9%2BQcrUi7bv%2FA9Q29Zf%2BkZqM%3D",

"createTime": "2023-11-02 07:31:09"

}

],

"hasNext": false,

"status": 0,

"msg": "success"

}

orderNo

Required

Order Number

emailReceivingDate

Required

The time at which the email has been received from the airline.

uniqueCode

Required

Unique Code of the email

emailCategory

Required

Options:

  • Schedule change

  • Receipt

  • Payment Success

  • Verification

  • Trip Reminder

  • Promo code

  • Travel Itinerary

  • Advertisement

from

Required

Email “from” address

to

Required

Email “to” address

emailSubject

Required

Email “Subject”

emailLink

Required

Email Link. Email Link is only valid for 10 mins.

createTime

Required

Create time End.

You can only query data for up to one month at a time

emailNotificationStatus

Optional

Notification Status

0=Notification not sent successfully

1=Notification sent successfully

The customer can download “emailLink”.

The email will be downloaded and when opened, it will show the email as sent by the airline:

Email Notification via Webhook

The customer server URL needs to be configured in ATRIP to receive the webhook notifications.

Webhook Notification

{

"cid":"pxmhg93103",

"data":{

"orderNo":"AEQTO20230711142920543",

"emailReceivingDate":"2023-08-04 15:58:52",

"uniqueCode":"017e7e70d729f6392144953bae1a68

68",

"emailCategory":"Unidentified",

"from":"[email protected]",

"to":"[email protected]",

"emailSubject":"Change to the time of your flydubai flight: Booking reference: 7RGWPY",

"emailLink":"http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/08/42e157e7f9f60e2ccda3693b19d2659a.eml?Expires=1691139906&OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&Signature=r69CnS7lt1rc8f4nZRrdxufI7Fk%3D",

"createTime":"2023-08-04 15:58:56"

},

"notificationId":"20230804160506282JUWFJ",

"status": -1,

"type":"email.all"

}

orderNo

Order Number

emailReceivingDate

The time Atlas received the airline's email.

Format: yyyy-MM-dd HH:mm:ss UTC+08:00

uniqueCode

Unique Code of the email

emailCategory

Atlas email categories. Atlas categorizes emails but does not guarantee accuracy in classification.

Options:

  • Schedule change

  • Receipt

  • Payment Success

  • Verification

  • Trip Reminder

  • Promo code

  • Travel Itinerary

  • Advertisement

from

Email “from” address

to

Email “to” address

emailSubject

Email “Subject”

emailLink

Email Link. Email Link is only valid for 10 mins.

createTime

The time when Atlas created this email record in the Email list. Generally, it will be later than the receiving time.

notificationId

Unique Code of the notification

status

Always equal to -1, internal field

type

Notification type. When type=email.all, the notification is the Email Notification.

Last updated

#29:

Change request updated