Hello,

We are writing to inform you we will be performing maintenance work on Smart Messaging Tailored.

Description: Implementation of four extra parameters in the delivery receipt on HTTP-based APIs.

PCR - 2232

Maintenance start time: 04/11/2020 - 01:00 am UTC

Maintenance end time: 04/11/2020 - 02:00 am UTC

Impact: None expected providing developers have not hard coded the processing position of the variables that they extract from the delivery receipt, the new delivery receipt variables will be ignored by their existing code. New and existing developers can also take advantage of the new parameters to handle concatenated delivery receipt processing as specified in the attached API document.

Affected API's

BT Smart Messaging Tailored HTTP Interface

BT Smart Messaging Tailored Template API

Detailed explanation: In order to improve the delivery receipt for concatenated SMS (Long text message), we have added four extra parameters in the delivery receipt.

Having extended delivery receipt information will greatly help processing concatenated messages. Extended delivery receipt information removes the complexity of matching multiple delivery receipts with the parent MT SMS as they can now use the mtMessageId and delivery status to track the parent & child delivery receipts.

The following four new parameters have been added to the delivery receipt:

1.MtMessageId > Identifier for the multiple segmented messages of a long SMS message. > 1-5 digits

2.MtStatus > Delivery status of the segmented messages of a long SMS message. > String enum. Possible values: [DELIVERED, ACCEPTED, REJECTED, EXPIRED, UNDELIVERABLE, UNKNOWN, DELETED]  

3.MtTotalSegments > Total number of concatenated messages that makes one long SMS message. In case the original message is not split, the value will be set to 1-1 > 2 digits.

4.MtSegmentNumber > Segment number of this concatenated message in a list of messages that makes one long SMS message. > mtSegmentNumber = 2, indicates Delivery Report of part 2 of the long SMS message.

We apologise for any inconvenience this may cause and will email you at the beginning and end of the maintenance period. If you have any questions or concerns, please contact our support team at support@tailored.bt.com

Best wishes,
Smart Messaging Tailored Team