5.2.13. Query SMS Delivery Status

<< Click to Display Table of Contents >>

Navigation:  5. Detailed description of the Actions > 5.2. Input Actions >

5.2.13. Query SMS Delivery Status

 
Icon: ANATEL~2_img317

 

Function: SMSQuery
 
Property window:

 

ANATEL~2_img319ANATEL~2_img318

 

Short description:

Query the SMS delivery Status.

 

Long Description:

Query the SMS delivery Status. The status of a SMS can be:

 

Status

Message

Description

NULL

NULL

The SMPP connection to the SMSC server failed.

1

ENROUTE

The message is in enroute state.

2

DELIVERED

Message is delivered to destination

3

EXPIRED

Message validity period has expired.

4

DELETED

Message has been deleted.

5

UNDELIVERABLE

Message is undeliverable

6

ACCEPTED

Message is in accepted state (i.e. it has been manually read on behalf of the subscriber by customer service)

7

UNKNOWN

Message is in invalid state

8

REJECTED

Message is in a rejected state

9

QUERY REQUEST FAILED

The SMSC server could not find your message (ID,Origin) amongst the known messages (IDs,Origins)

 

 

The SMSC server returns for the status of the SMS’s that are specified inside the input table. The SMSC identifies precisely each SMS based on 2 criterions:

The SMS ID (that is returned by the ANATEL~2_img320 SendSMSsmpp Action: See section 5.24.7)
 

The origin of the SMS.

 
Thus, inside the ANATEL~2_img317 QuerySMS Action, you need to specify the SAME origin as the origin that was used inside the ANATEL~2_img320 SendSMSsmpp Action (when sending the email). If the SMSC server does not find any SMS that matches the given ID and Origin, it returns Status=9 (QUERY REQUEST FAILED).

 

 
For each query to the SMSC server, you obtain 3 fields:
 

“SMS_STATE”: contains the status (ENROUTE, DELIVERED, EXPIRED, DELETED, UNDELIVERABLE, ACCEPTED, UNKNOWN, REJECTED, QUERY REQUEST FAILED)
 

“SMS_FINAL_DATE”: Date and time when the queried message reached a final state. For messages which have not yet reached a final state this field will contain a NULL.The date-time format is “YYMMDDhhmmss”.
 

“SMS_ERROR_CODE”: Where appropriate this holds a network error code defining the reason for failure of message delivery. The range of values this field may have, depends entirely on the underlying telecommunications network.