http://www.ibm.com/wsdl/soa/pxsms/v1_0/interface
SmsNotification is the application side notification interface to
which short messages are delivered.
This interface is part of the collection of Parlay
X outbound notifications supported by the PX Notification common
component.
Operations |
The notifySmsDeliveryReceipt method must be implemented by a
Web Service at the application side if it requires notification of
SMSdelivery receipt. It will be invoked by the Parlay X server to
notify the application when a SMS sent by an application has been
delivered to the terminal of the recipient or if delivery is
impossible. The notification will occur if and only if the status of
the sent SMS is DeliveredToTerminal or DeliveryImpossible and the
application has specified interest in notification when sending an
SMS message by specifying the optional receiptRequest parameter.
The correlator returned corresponds to the identifier specified by
the application in the receiptRequest of the original sendSMS
request.
When a SMS message is sent to multiple addresses, the
notification from the server will send notification for each
terminal as and when a SMS message is delivered to a
terminal.
The following three different SMS delivery status will be
returned in NotifySMSDeliveryReceiptResponse:
- 'DeliveryImpossible': unsuccessful delivery; the message
could not be delivered before it expired.
- 'DeliveredToTerminal': in case of concatenated messages, only
when all the SMS-parts have been successfully delivered to the
terminal.
- DeliveredNotificationNotSupported - If notification is
supported by the network but it does not support delivery
receipt for one or more addresses specified in the sendSMS
message. The service will send this status for those addresses.
|
The notification is used to send a short message to the
application. The notification will occur only if the SMS fulfils the
criteria specified when starting the SMS notification.
The notifySmsReception method must be implemented by a Web
Service at the application side. It will be invoked by the Parlay X
server to notify the application of the reception of an SMS. The
notification will occur if and only if the SMS received fulfils the
criteria specified in a provisioning step, identified by the
correlator. The criteria must at least include an
smsServiceActivationNumber, i.e. the SMS destination address that
can be "monitored" by the application. The parameter senderAddress
contains the address of the sender. The application can apply the
appropriate service logic to process the SMS.
|
|
XML |
-<wsdl:portType name="SmsNotification">
<xhtml:p>SmsNotification is the application side notification interface to
which short messages are delivered.</xhtml:p>
<xhtml:i>This interface is part of the collection of Parlay
X outbound notifications supported by the PX Notification common
component.</xhtml:i> </xhtml:b> </xhtml:p>
</wsdl:documentation>
-<wsdl:operation name="notifySmsReception">
<xhtml:p>The notification is used to send a short message to the
application. The notification will occur only if the SMS fulfils the
criteria specified when starting the SMS notification.</xhtml:p>
<xhtml:p>The notifySmsReception method must be implemented by a Web
Service at the application side. It will be invoked by the Parlay X
server to notify the application of the reception of an SMS. The
notification will occur if and only if the SMS received fulfils the
criteria specified in a provisioning step, identified by the
correlator. The criteria must at least include an
smsServiceActivationNumber, i.e. the SMS destination address that
can be "monitored" by the application. The parameter senderAddress
contains the address of the sender. The application can apply the
appropriate service logic to process the SMS.</xhtml:p>
</wsdl:documentation>
</wsdl:operation>
-<wsdl:operation name="notifySmsDeliveryReceipt">
<xhtml:p>The notifySmsDeliveryReceipt method must be implemented by a
Web Service at the application side if it requires notification of
SMSdelivery receipt. It will be invoked by the Parlay X server to
notify the application when a SMS sent by an application has been
delivered to the terminal of the recipient or if delivery is
impossible. The notification will occur if and only if the status of
the sent SMS is DeliveredToTerminal or DeliveryImpossible and the
application has specified interest in notification when sending an
SMS message by specifying the optional receiptRequest parameter.
The correlator returned corresponds to the identifier specified by
the application in the receiptRequest of the original sendSMS
request.</xhtml:p>
<xhtml:p>When a SMS message is sent to multiple addresses, the
notification from the server will send notification for each
terminal as and when a SMS message is delivered to a
terminal.</xhtml:p>
<xhtml:p>The following three different SMS delivery status will be
returned in NotifySMSDeliveryReceiptResponse:</xhtml:p>
<xhtml:li>'DeliveryImpossible': unsuccessful delivery; the message
could not be delivered before it expired.</xhtml:li>
<xhtml:li>'DeliveredToTerminal': in case of concatenated messages, only
when all the SMS-parts have been successfully delivered to the
terminal.</xhtml:li>
<xhtml:li>DeliveredNotificationNotSupported - If notification is
supported by the network but it does not support delivery
receipt for one or more addresses specified in the sendSMS
message. The service will send this status for those addresses.</xhtml:li>
</xhtml:ul>
</wsdl:documentation>
</wsdl:operation>
</wsdl:portType>
|
Used-By |
|