Methods - ReadTextMT

This method is used to proactively retrieve all inbound SMS messages sent to a TextPremium Short Code and Keyword. This method does not delete the retrieved messages.

This method is not relevant when you have configured, online, for all inbound messages to be automatically sent to a nominated URL. This automated approach is the most common and efficient means of receiving inbound messages.

» Client_ID	» String
» Client_Pass	» String
» Inbound_Number	» String

Received messages sent to Inbound_Number or an error message as XML contained within a string, are returned. XML carrying messages are structured as follows:


        <?xml version="1.0"?> 
        <Messages> 
            <Message  ID="1"> 
                <SRC>447890123456</SRC> 
                <DST>80000</DST> 
                <RBID>00000000000</RBID> 
                <TDate>04/04/04</TDate> 
                <TTime>10:00</TTime>
                <Body>keyword</Body> 
            </Message> 
            <Message ID="…"> 
            … 
            </Message> 
        </Messages>

where:

» Messages: contain one or more Message elements.
» Message: Contains source (SRC), destination (DST), reverse billing identifier required for SendMTResponse (RBID), date received (TDate), time received (TTime) and the body (Body) of the message.
» TDate:is in the UK format dd/mm/yy.
» TTime:is in 24 hour format. Each Message element has an ID attribute which is used to remove the message from the server using the DeleteTextMOMT method.

If there is an error during the method call, the returned XML will be structured as follows:


    <?xml version="1.0"?> 
    <Error>
        <Description>ERROR_DESCRIPTION</Description>
    </Error>

The Description element will contain information relevant to the error which occurred.