Messaging (SMS) in Softphone.Pro Team

Supported in Softphone.Pro 5.3 and newer. Softphone.Pro can only send messages, receiving messages feature isn't provided as of the date of this article.

Softphone.Pro supports messaging and SMS via SIP MESSAGE or HTTP API.

• SIP MESSAGE allows sending SMS or messages via compatible PBX.
• Alternatively use HTTP API in order to send SMS or messages to your PBX or messaging service server.

Use this manual to configure and use messaging in Softphone.Pro Team.

Messaging configuration

SIP MESSAGE configuration

Your PBX should support SIP MESSAGE messaging method. Contact your PBX support or check PBX documentation to make sure that it is so.

1. Go to Settings - Softphone.Pro - General settings:

2. Enable Messaging feature. Pick SIP MESSAGE from the Messaging communication protocol dropdown:

3. Click Save and restart Agents' softphones.

4. SIP MESSAGE configuration is finished. Go to Messaging usage section to find out how Agent can send SMS and messages from their softphone.

If your PBX doesn't support SIP MESSAGE protocol you may use HTTP API to send messages and SMS.

HTTP API configuration

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

1. Go to Settings - Softphone.Pro - General settings:

2. Enable Messaging feature. Pick SIP MESSAGE from the Messaging communication protocol dropdown 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.

3. Click Save and restart Agents' softphones.

4. HTTP API configuration is done. Please read how Agent can send SMS and messages from their softphone.

5. 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

Use softphone provisioning to configure additional messaging 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 MessageMaximumLength parameter of [AppSettings] section in Team user's Softphone.Pro settings.

Softphone.Pro saves the last 100 messages by default. If you need to store more messages, use MaxNumberStoredMessages parameter of [AppSettings] section in Team user's Softphone.Pro settings.

Messaging usage

1. Open messaging window.

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

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

Destination number will be filled automatically.

See all articles