Text message

General

IP address text message service

The text message service on port 2544 runs on all IP addresses of the UM computer by default (Automatic setting). This setting does not usually need to be changed. However, if this is required, IP address and Port can be assigned individually in manual mode.

If the operating system-internal SMTP service is also to be run on the UM computer, a patch delivered by Microsoft is necessary since the operating system service connects to all IP addresses of a computer. You can find this patch on the installation CD in the ServerTools directory.

Text message domain

When sending a text message via the email client, a text message number with an attached SMTP domain needs to be specified in the address field (e.g. 12345@sms.firma.com). It is advisable that you select the domain name of the company here preceded by the word sms.

These two settings must be entered accordingly in the SMTP routing of the email server. The settings cause emails addressed to the specified domain to be forwarded to the IP socket of the text message service, which interprets them as text messages.

If delivery is delayed, discard message after X hours

Here you set the length of time the text message service should wait for a send confirmation from the text message centre. The user is notified if this time elapses without receiving a send confirmation.

Advanced settings

Only change these settings when advised to do so by product support.

Click Add to configure special parameters and values. Click Apply to accept the selected parameter and the values you have set for it, or click Cancel to discard your changes. You will return to General SMS settings. You can add additional parameters or modify existing ones with Edit or delete parameters with Delete. Click Save again to apply the selected parameters with the set values.

Parameter:

Name	Description	Value
MaxSendAttemptCount	Maximum number of attempts to send a text message before the user receives a delivery failure message.
SleepForAnalogCapi	Waiting time before the text message is sent via analogue CAPI.	(in milliseconds)
SleepForDigitalCapi	Waiting time before the text message is sent via digital CAPI	(in milliseconds)
TimeBetweenSendAttempt	Waiting period between two attempts to send a text message after a delivery failure	(in minutes)
TimeSpanToSend	Maximum time allotted before the user receives a delivery failure message	(in minutes)

Routing

Routing list

In this section, you can specify the text message centre via which text messages are to be sent to certain telephone numbers.

When clicking on Add, you can allocate the telephone numbers to a text message gateway:

• The recipient’s telephone number starts with

• Send text message via the following gateway

Click Apply to save the selected parameter with the set values or Cancel to discard the changes. You will return to the text message routing settings. You can now add additional telephone numbers or modify existing ones with Edit or delete parameters with Delete. Click Save again to apply.

Hint

This list can also be blank.

If you have configured several gateways, the text messages are sent using the “best match” method; if no match is found in the routing list, they are sent via the default gateway.

Default gateways

Here you define the text message gateway, which is to be used for operation.

An entry from the text message gateway list must be selected as default gateway:

• International BULKSMS.com

• International mes.mo any-sms.info

• Switzerland Swisscom UCP Serie 60

To add or edit a new SMS gateway change to the path System settings > UM > Text message > Gateways.

Gateways

Several gateways are available for sending text messages. Each provider / gateway defines a number of access parameters, e.g. the protocol to be used, character set, telephone number, etc.

Which gateway should be used as default SMS gateway, you set under System settings > UM > Text message > Routing under default gateway.

Tip

Advantage for XPhone Connect Clients: 5 euros start balance at mes.mo Any-SMS. Follow the link below and enter voucher code: XPHONESMS.

Creating / editing

To create a text message gateway, click New text message gateway. You can now select between HTTP and UCP.

Delete

You can delete a text message gateway by selecting the corresponding entry and click Remove.

Text message HTTP gateway

General

• Gateway name

  • Enter any name here.

• URL

  • Is provided by the provider (http or https). Allowed placeholders in the parameter list:

    • <login> for security / login name

    • <password> for security / password

    • <message> text message text

    • <recipient> recipient telephone number

    • <sender> sender telephone number

• Body

  Used for the parameter list, if the provider works with HTTP-POST. The parameters are attached in the URL in HTTP-GET.

• Positive response from the server

  Describe syntax: Entering a search text which is interpreted as positive response.

• Negative response from the server

  Describe syntax:

  [suchtext-x]
  DE="deutsche Fehlermeldung x"
  EN="englische Fehlermeldung x"
  IT="italienische Fehlermeldung x"
  FR="französische Fehlermeldung x"
  
  [suchtext-y]
  DE="deutsche Fehlermeldung y"
  EN="englische Fehlermeldung y"
  IT="italienische Fehlermeldung y"
  FR="französische Fehlermeldung y"
  

• Security

  Enter the login data here you obtained from your provider.

• Proxy server

  You can make proxy settings here if required.

• Advanced settings

  Only use the Advanced settings after consultation with product support.

Security

• Login name

• Password

Proxy server

• Check box - Use proxy server

• IP address

• Port

• Domain

• Login name

• Password (The password is hidden immediately during entering. To display the password in clear text and to check the correct spelling, click on the symbol at the end of the field. This symbol is only shown once if you have to enter the password again.)

Advanced settings

Advanced settings are optional and only required in certain cases. If desired or required by your company structure, you can use Add to specify the following additional parameters.

Parameter:

Name	Description	Value
ConvertType	Character set conversion
MaxChannels	Number of gateway instances
MaxMsgLen	Max. text message length
MaxNumMsgs	Maximum number of reserved text messages
NumberFormat	Phone number format	1: internation with 00 [1] 2: internation with + [2] 3: E.164 Format e.g. 49 [3]
ReceiveMaxNumMsgs	Number of received SMS in one poll cycle
ReceiveTimeout	Poll cycle of the modem
Timeout	Server timeout
HttpContentType	Other Content Type [4]	application/x-www-form-urlencoded (Default)

[1]

Gateway expects the phone number in international phone number format starts with ‘00’, e.g. ‘0049’ for Germany.

[2]

Gateway expects the phone number in international phone number format starts with ‘+’, e.g. ‘+49’ for Germany.

[3]

Gateway expects the phone number in E.164 format, e.g. ‘49’ for Germany.

[4]

If an HTTP provider expects a different content-type in the header, settings can be made here. For example, if an HTTP provider expects JSON: application/json

Hint

You can obtain parameters and values from product support. They will find out together with you, which parameters are useful for the corresponding circumstances and which values will result in a solution to the issue.

Click Apply to save the selected parameter with the set values or Cancel to discard the entries. You will return to the General UM settings. You can now add further additional parameters, modify existing ones via Edit or delete parameters with Remove. Click Save again to accept the selected parameters with the set values.

SMS UCP Gateway

General

• Gateway name

• Typ (UCP 50 / UCP60)

• Character set table ( *.att)

Link to text message centre

• Connection only possible via TCP-IP!

• Telephone number of text message centre

• Protocol (V.120 / X.75 / Analogue)

Security

Check box - Text message centre requests authentication

Advanced settings

Advanced settings are optional and only required in certain cases. If desired or required by your company structure, you can use Add to specify the following additional parameters.

Parameter:

Name	Description	Value
ConvertType	Character set conversion
MaxChannels	Number of gateway instances
MaxMsgLen	Max. text message length
MaxNumMsgs	Maximum number of reserved text messages
NumberFormat	Phone number format	1: internation with 00 [5] 2: internation with + [6] 3: E.164 Format e.g. 49 [7]
ReceiveMaxNumMsgs	Number of received SMS in one poll cycle
ReceiveTimeout	Poll cycle of the modem
Timeout	Server timeout
HttpContentType	Other Content Type [8]	application/x-www-form-urlencoded (Default)

[5]

Gateway expects the phone number in international phone number format starts with ‘00’, e.g. ‘0049’ for Germany.

[6]

Gateway expects the phone number in international phone number format starts with ‘+’, e.g. ‘+49’ for Germany.

[7]

Gateway expects the phone number in E.164 format, e.g. ‘49’ for Germany.

[8]

If an HTTP provider expects a different content-type in the header, settings can be made here. For example, if an HTTP provider expects JSON: application/json

Hint

You can obtain parameters and values from product support. They will find out together with you, which parameters are useful for the corresponding circumstances and which values will result in a solution to the issue.

Click Apply to save the selected parameter with the set values or Cancel to discard the entries. You will return to the General UM settings. You can now add further additional parameters, modify existing ones via Edit or delete parameters with Remove. Click Save again to accept the selected parameters with the set values.

Have you found a mistake on this page?

Or is something not formulated well or too vague? Then we look forward to receiving an e-mail, preferably with a suggestion for improvement, to doku@c4b.de. Thank you very much!