Messaging in Softphone.Pro

Supported only in Softphone.Pro 5.3 or newer. Softphone.Pro can only send messages, receiving messages feature isn't supported.

Softphone.Pro supports messaging with different methods, such as SIP MESSAGE or HTTP API. Use this manual to configure and use messaging in Softphone.Pro.

Messaging configuration

SIP MESSAGE configuration

Your PBX must support SIP MESSAGE messaging method. Contact your PBX support or check PBX documentation to make sure that it does.

1. Open Messaging settings section and check Enable messaging and texting (SMS) option:

Enable messaging

2. In the Messaging communication protocol parameter pick SIP MESSAGE and click Save:

Save SIP MESSAGE settings

HTTP API configuration

Your PBX must support HTTP API messaging method. Contact your PBX support or check PBX documentation to make sure that it does.

1. Open Messaging settings section and check Enable messaging and texting (SMS) option:

Enable messaging

2. In the Messaging communication protocol parameter pick HTTP API and enter parameters:

  • Messaging gateway URL - enter URL which will be receiving messaging requests.
    For example: http://example.com
  • HTTP API security token - it will be added to message request header.
    For example: token123.

Save HTTP API settings

3. Click Save.

4. When the message is sent Softphone.Pro will send a POST request to the URL specified in the Messaging gateway URL parameter:

  POST
    headers: {
      'content-type': 'application/json',
      'authorization': 'Bearer token123',
      "content-length": "70",
      "accept-encoding": "gzip, deflate",
      "accept-language": "ru-RU,en,*"
    }
    body: {
        "from": "100",
        "message_body": "Hello world",
        "to": "101"
    }
  
  • headers.authorization has the value of Bearer %TOKEN%, where %TOKEN% is HTTP API security token in messaging settings.
    In this example: Bearer token123;
  • body.from is the sender number (SIP login of the account selected in the main app window).
    In this example: 100;
  • body.message_body - message text.
    In this example: Hello world;
  • body.to - receiver number.
    In this example: 101.

Additional settings

By default the character limit in message is set at 200. If your PBX is configured with a different value, set it in the messaging settings, in the Message maximum length parameter:

Set message character limit

Softphone.Pro saves the last 100 messages by default. If you need to store more messages, use MaxNumberStoredMessages parameter of the [AppSettings] section in Softphone.Pro configuration file.

Messaging usage

1. Open messaging window.

2. Select outbound SIP account in the main window. Enter destination number and the message text. Click Send:

Send message from Messaging window

3. You can also make use of message buttons in the contacts list and in the Active Calls windows:

Sending messages from contacts and Active Calls

Destination number will be filled automatically.