SMS Gateway - Code Samples

XML Samples

The following XML samples outline the structure and fields present in the request that is submitted to TextPort and the response that is received back to your calling service. Enumerations for the country codes are listed at the bottom of the page.

Contents of XML Request

<?xml version="1.0" encoding="utf-16"?>
<TextPortSMSMessages xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <UserName>your_username</UserName>
  <Password>your_password</Password>
  <Messages>
    <TextPortSMSMessage>
      <MessageText>Place the body of the text message in this field.</MessageText>
      <CountryCode>US</CountryCode>
      <MobileNumber>9505551212</MobileNumber>
    </TextPortSMSMessage>
    <TextPortSMSMessage>
      <MessageText>This is the body of the second message in the request.</MessageText>
      <CountryCode>US</CountryCode>
      <MobileNumber>9365552121</MobileNumber>
    </TextPortSMSMessage>
  </Messages>
</TextPortSMSMessages>
                    

Contents of XML Response

<?xml version="1.0" encoding="utf-16"?>
<TextPortSMSResponses xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ExtensionData />
  <Responses>
    <TextPortSMSResponse>
      <ExtensionData />
      <ErrorMessage />
      <ItemNumber>1</ItemNumber>
      <MessageID>444</MessageID>
      <ProcessingMessage>Validating message request 1. Validation completed successfully. Message processed successfully.</ProcessingMessage>
      <MobileNumber>9505551212</MobileNumber>
      <Result>Success</Result>
    </TextPortSMSResponse>
    <TextPortSMSResponse>
      <ExtensionData />
      <ErrorMessage />
      <ItemNumber>2</ItemNumber>
      <MessageID>0</MessageID>
      <ProcessingMessage>Validating message request 2. Validation completed successfully. Your message was not sent. The number 9365552121 was not recognized as a number handled by a mobile carrier. 
      </ProcessingMessage>
      <MobileNumber>9365552121</MobileNumber>
      <Result>Failed</Result>
    </TextPortSMSResponse>
  </Responses>
</TextPortSMSResponses>
                    

Code Samples

Submit Messages Using the WCF Service (C#)

private void submitSMSToTextPort()
{
    using (TextPortSMSService.TextPortSMSClient textPortSvc = new TextPortSMSService.TextPortSMSClient())
    {
        TextPortSMSService.TextPortSMSMessages messageList = new TextPortSMSService.TextPortSMSMessages()
        {
            UserName = "your_account_name_here ",
            Password = "your_password_here",
            Messages = new List<TextPortSMSService.TextPortSMSMessage>()
        };

        // Add first message
        messageList.Messages.Add(new TextPortSMSService.TextPortSMSMessage()
        {
            CountryCode = "US",
            MobileNumber = "5725551212",
            MessageText = "Place the body of the text message in this field."
        });

        // Add second message
        messageList.Messages.Add(new TextPortSMSService.TextPortSMSMessage()
        {
            CountryCode = "IN",
            MobileNumber = "917365552121",
            MessageText = "This message will be routed to India."
        });

        // Add more messages here...

        // Submit the messages to the TextPort service
        TextPortSMSService.TextPortSMSResponses responseList = textPortSvc.SendMessages(messageList);

        foreach (TextPortSMSService.TextPortSMSResponse resp in responseList.Responses)
        {
            Console.WriteLine("Message #" + resp.ItemNumber.ToString() + " submitted with result " + resp.Result);
        }
    }
}
                

Submit Messages to the ASMX (SOAP) service using PHP

The following link demonstrates integration with the TextPort SMS web services using PHP. (Sample provided courtesy of Matthew Watts).
https://github.com/mwatts7222/TextPort-PHP/blob/master/textPortConsume.php

ISO 2-character Country Codes

The values passed in the CountryCode property of the request must be one of the following:

Country Name	Code
Afghanistan	AF
Albania	AL
Algeria	DZ
Angola	AO
Argentina	AR
Armenia	AM
Australia	AU
Austria	AT
Azerbaijan	AZ
Bahrain	BH
Bangladesh	BD
Barbados	BB
Belarus	BY
Belgium	BE
Belize	BZ
Bolivia	BO
Botswana	BW
Brazil	BR
Bulgaria	BG
Cambodia	KH
Cameroon	CM
Canada	CA
Cayman Islands	KY
Chad	TD
Chile	CL
China	CN
Colombia	CO
Comoros	KM
Costa Rica	CR
Croatia	HR
Cuba	CU
Cyprus	CY
Czech Republic	CZ
Denmark	DK
Djibouti	DJ
Ecuador	EC
Egypt	EG
El Salvador	SV
Equatorial Guinea	GQ
Estonia	EE
Ethiopia	ET
Fiji	FJ
Finland	FI
France	FR
Gabon	GA
Gambia	GM
Georgia	GE
Germany	DE
Ghana	GH
Greece	GR
Greenland	GL
Guam	GU
Guatemala	GT
Guinea	GN
Guyana	GY
Haiti	HT
Honduras	HN
Hong Kong	HK
Hungary	HU
Iceland	IS
India	IN
Indonesia	ID
Iran	IR
Iraq	IQ
Ireland	IE
Israel	IL
Italy	IT
Jamaica	JM
Japan	JP
Jordan	JO
Kazakhstan	KZ
Kenya	KE
Korea	KR
Kuwait	KW
Kyrgyzstan	KG
Laos	LA
Latvia	LV
Lebanon	LB
Lesotho	LS
Liberia	LR
Lithuania	LT
Luxembourg	LU
Madagascar	MG
Malaysia	MY
Mauritius	MU
Mexico	MX
Monaco	MC
Mongolia	MN
Morocco	MA
Mozambique	MZ
Nepal	NP
Netherlands	NL
New Zealand	NZ
Nicaragua	NI
Niger	NE
Nigeria	NG
Norway	NO
Oman	OM
Pakistan	PK
Panama	PA
Paraguay	PY
Peru	PE
Philippines	PH
Poland	PL
Portugal	PT
Puerto Rico	PR
Qatar	QA
Romania	RO
Russia	RU
Rwanda	RW
Samoa	WS
San Marino	SM
Saudi Arabia	SA
Senegal	SN
Serbia	RS
Seychelles	SC
Sierra Leone	SL
Singapore	SG
Slovakia	SK
Slovenia	SI
Somalia	SO
South Africa	ZA
Spain	ES
Sri Lanka	LK
Sudan	SD
Suriname	SR
Swaziland	SZ
Sweden	SE
Switzerland	CH
Syria	SY
Taiwan	TW
Tanzania	TZ
Thailand	TH
Togo	TG
Tonga	TO
Trinidad and Tobago	TT
Turkey	TR
Turkmenistan	TM
Uganda	UG
Ukraine	UA
United Arab Emirates	AE
United Kingdom	GB
Uruguay	UY
USA	US
Uzbekistan	UZ
Vanuatu	VU
Venezuela	VE
Vietnam	VN
Virgin Islands, British	VG
Yemen	YE
Zambia	ZM
Zimbabwe	ZW