StartSmsCallback

Tells the ThingSpace Platform to start sending mobile-originated SMS messages through the EnhancedConnectivityService callback service. SMS messages from devices are queued until they are retrieved by your application, either by callback or synchronously with the GetSmsMessages API method.

Request Parameters

Parameter Type Description
AccountName
required
string

The name of the billing account that the devices belong to..

An account name is usually numeric, and must include any leading zeros.

Response Parameters

The API returns an empty response.

Example SOAP Request

<v2:StartSmsCallback>
  <v2:Input>
    <nph:AccountName>0286894207-00001</nph:AccountName>
  </v2:Input>
</v2:StartSmsCallback>

Example SOAP Response

<StartSmsCallbackResponse xmlns="http://nphase.com/unifiedwebservice/v2">
  <Output xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:a="http://schemas.datacontract.org/2004/07/NPhase.UnifiedWebService.APIs.v2.Contract.EnhancedConnectivityService"/>
</StartSmsCallbackResponse>

Callback for Mobile-Originated SMS Message

This example shows a mobile-originated SMS message from a device that is programmed to send some status information.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SmsCallbackRequest xmlns="http://nphase.com/unifiedwebservice/v2">
      <Username/>
      <Password/>
      <Device>
        <Kind>esn</Kind>
        <Identifier>60E5F99D</Identifier>
      </Device>
      <Device>
        <Kind>mdn</Kind>
        <Identifier>7022895555</Identifier>
      </Device>
      <SmsMessage>reply from CA1282117271002: status IP 10.226.22.2 Network Ready : EV-DO Rev.A.  RSSI -67 Lat=+47.26 Long=+120.16 Time=22:18:08</SmsMessage>
    </SmsCallbackRequest>
  </s:Body>
</s:Envelope>

Request Schema Diagram

Response Schema Diagram