Navigation:  Reference > Gateway properties > SMPP gateway

Only available in Diafaan SMS Server - basic and full editions.

 

SMPP server properties

---

Host or IP number

The host name or IP number of the SMPP server.

 

Server port

The port number of the SMPP server. Port number 2775 is the default port for the SMPP protocol but other port numbers are also common.

 

SMPP version

Most SMPP servers support both version 3.3 and 3.4 of the SMPP protocol. Some advanced features of the protocol are only supported in version 3.4 but basic messaging is the same for both versions.

.

User name

The user name (or System ID) of your SMPP account.

 

Password

The password of your SMPP account.

 

Default source address

Some SMPP operators require that you send a source address or sender id with each message. The default source address will be used for each message where the user does not provide a source address.

 

Users can override the default source address

If you do not want users to send their own source addresses with the messages you can disable this option here. Some SMPP operators block messages with an unapproved source address, in the ApprovedSourceAddress property in the advanced settings you can provide a list with valid source addresses.

 

 

Advanced properties

---

LogCommunicationToFile

Log all internet communication to file. Use this option only if you encounter problems with the connection to your SMPP account. If enabled, the status windows of the SMPP gateway provides a link to the location on you hard disk where the file is stored.

 

Number template

The number template can be used to translate the number from one format to another. For more information see Use number templates.

 

MaximumBatchSize

The maximum number of messages this gateway will process in one batch. If this value is higher than one and a number of messages are sent at the same time, the gateway loads multiple messages concurrently. This increases the speed in which the messages are sent.

 

AsyncModeWindowSize

If this property is set to a value higher than 1, the SMPP gateway does not wait for a response from the SMPP server before the next message is sent. This can increase message throughput considerably but if the AsyncModeWindowSize is set too high or if the SMPP server does not support asynchronous mode properly it can lead to overloading of the SMPP server.

 

Characterset

If SMS messages containing a @ are not properly received on the receiving phone then the character set of the  SMPP server should be set to a different value.

 

KeepAliveInterval

The SMPP Gateway sends an enquire_link message to the SMPP server after a period of inactivity to keep the connection to the SMPP server intact. If the SMPP server keeps breaking the connection after a certain time the timeout interval can be set here.

 

MaxMessagesPerMinute

The MaxMessagesPerMinute property limits the amount of messages that the SMPP Gateway will send each minute. Some SMPP servers enforce a strict message throttling and sending more messages then are allowed might actually decrease message throughput.

 

SystemType

The system type is a text that the SMPP Gateway sends to the SMPP server to signal what sort of service it is. Some SMPP servers require a specific system type value.

 

TransceiverMode

By default, the SMPP Gateway starts up two connections to the SMPP server., one for sending messages and one for receiving messages. SMPP version 3.4 supports a transceiver mode where one connection is used for both sending and receiving messages.

 

UsePayloadTLV

In SMPP version 3.3 long SMS messages must be broken up in multiple segments before they are sent to the SMPP server. SMPP version 3.4 supports an additional Payload parameter that can be used to send a long SMS message in one segment. Not all SMPP servers support the Payload parameter, even when they do support SMPP version 3.4.

 

ValidityPeriod

The validity period of sent messages, specified as a relative date and time in the format YYMMDDhhmmss000R. E.g. 000003000000000R specifies a validity period of 3 days.

Leave empty for the default validity period of the SMPP server.

 

ApprovedSourceAddressList

SMPP supports both numeric and text source addresses. To prevent spoofing, some SMPP operators require that source addresses have to be approved before you can use them. the ApprovedSourceAddressList can contain a list of valid source addresses, if the source address is not in the list the default source address is used instead.

If the ApprovedSourceAddressList is empty all source addresses are valid.

 

CombineMultiPartMessage

If enabled, partial received messages are combined to the original message length. Since delivery of some message parts might be delayed this could mean that the delivery of the whole message will be delayed. If, after a certain timeout, not all message parts are received, the partial messages are delivered individually. If disabled, the partial messages are delivered individually.

CombineMultipartMessages can also be set to Binary. In this mode the received messages are not decoded and combined but forwarded as message type sms.binary.smpp with the message field set to <DCS>,<PID>,<ESMCLASS>,<UDH>,<Data>. This may be useful if you intend to use Diafaan SMS Server to retransmit the messages unaltered to one or more alternative receivers.

 

DeliveryConfirmation

Require status updates for the SMS messages after it is sent to the SMSC. If you do not need to know if the SMS messages are delivered on the mobile phone you can disable status updates here.

 

DefaultAddressType

The address type (TON) that is used when no specific address type is detected. The detection of the address type is as follows:

•If the address starts with a + it is regarded as an international phone number (TON 1 and NPI 1).

•If characters are detected it is an alphanumeric source address (TON 5 and NPI 0)

•If it has less than MaxShortCodeLength numbers it is a shortcode (TON 3 and NPI 1)

•The default address type value is used with NPI 1.

 

MaxMessageParts

Messages to send that are longer than 160 characters or 70 characters for unicode messages can be split in multiple SMS messages that are recombined to one message on the handset of the receiver. The MaxMessagePart property limits the amount of partial messages that the gateway sends with a long message. If the message is longer than can be sent with the maximum message parts, the rest of the message is discarded.

 

MaxShortCodeLength

The maximum number length where the number is regarded as a short code, short codes are encoded as Network Specific numbers.

 

MessageType

The message type is the default value for the SMS message encoding, the default value may be replaced with the message type specified by the sending Connector.

The gateway uses four possible value for the default message type:

 

 

The GSM Modem gateway supports the following custom message types: