Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 4 Next »

If an account has been configured to use Source Routing then any replies to messages can be routed back through the SMS gateway to the original sender.

Reply messages can be forwarded to
1. an email address
2. a remote URL

The ReplyTo address is set when the original batch is submitted.

EMAIL

type = EMAIL
value must start mailto:

<REPLYTO>
	<ADDRESS type="EMAIL" role="REPLYTO" value="mailto:my.account@company.com?subject=reply+SMS"/>
</REPLYTO>

HTTP

type = URL
value must start http:

<REPLYTO>
	<ADDRESS type="URL" role="REPLYTO" value="http://sms.company.com/receive?/text=%%TEXT%%&amp;from=%%FROM%%"/>
</REPLYTO>

Custom Attributes

To use "reply to" with custom attributes

Eg customer wants to send out SMS to 3 car owners with regos: ABC123, DEF456 & HIJ789

You can set the rego in the URL query string

SMS # 1

<REPLYTO>
<ADDRESS type="URL" role="REPLYTO" value="http://sms.company.com/receive?text=%%TEXT%%&from=%%FROM%%&rego=ABC123"/>
</REPLYTO>

SMS #2

<REPLYTO>
<ADDRESS type="URL" role="REPLYTO" value="http://sms.company.com/receive?text=%%TEXT%%&from=%%FROM%%&rego=DEF456"/>
</REPLYTO>

SMS #3

<REPLYTO>
<ADDRESS type="URL" role="REPLYTO" value="http://sms.company.com/receive?text=%%TEXT%%&from=%%FROM%%&rego=HIJ789"/>
</REPLYTO>

This method can be used to set other identifying attributes; eg your own message id.

Example Document

<!DOCTYPE DOCUMENT SYSTEM "http://localhost:8080/gateway/msg_core.dtd">
<DOCUMENT mode="NORMAL">

<SENDER password="myPassword">
	<ADDRESS type="EMAIL" role="FROM" value="my.account@company.com"/>
</SENDER>
<REPLYTO>
	<ADDRESS type="URL" role="REPLYTO" value="http://sms.company.com/receive?/text=%%TEXT%%&amp;from=%%FROM%%"/>
</REPLYTO>

<SMS>
	<HEADER></HEADER>
	<FOOTER></FOOTER>
</SMS>

<MESSAGE>
	<ADDRESS type="SMS" role="TO" value="0410123123"/>
	<BODY type="TEXT">
		<PAYLOAD type="TEXT" encoding="ASCII">text of message to send</PAYLOAD>
	</BODY>
</MESSAGE>
</DOCUMENT>

Source Routing XML (simple)

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE DOCUMENT SYSTEM "http://localhost:8080/gateway/msg_core.dtd">
<DOCUMENT mode="NORMAL">
        <SENDER password="XXX">
                <ADDRESS type="EMAIL" role="FROM" value="test@company.com"></ADDRESS>
        </SENDER>
        <REPLYTO>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=one"></ADDRESS>
        </REPLYTO>
        <MESSAGE>
                <ADDRESS type="SMS" role="TO" value="61401043783"></ADDRESS>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test one</PAYLOAD>
                 </BODY>
        </MESSAGE>
</DOCUMENT>

Source Routing XML (multi)

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE DOCUMENT SYSTEM "http://localhost:8080/gateway/msg_core.dtd">
<DOCUMENT mode="NORMAL">
        <SENDER password="XXX">
                <ADDRESS type="EMAIL" role="FROM" value="test@company.com"></ADDRESS>
        </SENDER>
        <REPLYTO>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=default"></ADDRESS>
        </REPLYTO>

        <MESSAGE>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=one"/>
                <ADDRESS type="SMS" role="TO" value="61401043783"/>
                <ADDRESS type="SMS" role="TO" value="61401044039"/>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test one</PAYLOAD>
                 </BODY>
        </MESSAGE>

        <MESSAGE>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=two"/>
                <ADDRESS type="SMS" role="TO" value="61401043783"/>
                <ADDRESS type="SMS" role="TO" value="61401044039"/>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test two</PAYLOAD>
                 </BODY>
        </MESSAGE>

        <MESSAGE>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=three"/>
                <ADDRESS type="SMS" role="TO" value="61401043783"/>
                <ADDRESS type="SMS" role="TO" value="61401044039"/>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test three</PAYLOAD>
                 </BODY>
        </MESSAGE>

        <MESSAGE>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=four"/>
                <ADDRESS type="SMS" role="TO" value="61401043783"/>
                <ADDRESS type="SMS" role="TO" value="61401044039"/>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test four</PAYLOAD>
                 </BODY>
        </MESSAGE>

        <MESSAGE>
                <ADDRESS type="EMAIL" role="REPLYTO" value="support@company.com?subject=five"/>
                <ADDRESS type="SMS" role="TO" value="61401043783"/>
                <ADDRESS type="SMS" role="TO" value="61401044039"/>
                 <BODY type="TEXT">
                     <PAYLOAD type="TEXT" encoding="ASCII">This is test five</PAYLOAD>
                 </BODY>
        </MESSAGE>

</DOCUMENT>
  • No labels