Home / Integration plugins / 3CX – SMS Integration

3CX SMS messaging – integration manual

Here we describe how to setup 3CX with SMSEagle device for SMS/MMS messaging support. The integration process is easy and should take 10-15 minutes to complete.

SMSEagle is an offline hardware SMS gateway. Therefore no external connection to 3rd party system is required. All notifications are generated on-premise and sent directly to a cellular network. This solution can be used in secure installations without Internet access.

SMSEagle Setup

  1. Create a new user in SMSEagle (menu Users > + Add Users, user access level: “User”).
  2. Grant API access to the created user:
    • click Access to API beside the newly created user.
    • Enable APIv2
    • Generate new token (copy it and paste it on API Key field on the trunk where the number resides)
    • Add access permissions in section 3CX Permission for: Forward a message from 3CX system.
    • Save settings.
  3. On menu go to Callback URL and click add new rule:
    • Add a rule name e.g. 3CX System.
    • Under URL field paste the 3CX webhook URL generated from 3CX Setup
    • The URL Method chose: POST (3CX)
    • On the To(3CX) put the number that the messages will be terminated to as per 3CX config
    • And save.

3CX Setup

The below setup works only with Professional and Enterprise (Self hosted) 3CX license.

1) Connect to 3CX Web Client then navigate to Admin Console where you can find the section Voice & Chat:

2) Click on Add a Trunk, then the below page will show up. You need to select Country > World Wide and on the Provider field you select “Generic VoIP Provider (IP Based)”.

On the Main Trunk number field please enter the number that you have inserted to the Modem of SMS Eagle.

On the Server field please enter the FQDN of the 3CX instance.

3) Under SMS section you need to enable the service and the required filed will be highlighted. The API key field and Provider URL.:

    • API Key = That we will generate from SMS Eagle via Users > Access to API > Generate token.
    • Provider URL = Is the HTTPS endpoint of API SMS Eagle (HTTP is not supported for 3CX). The link should be in this format: https://SMSEagleFQDN/api/v2/messages/message_3cx
    • 3CX Webhook URL = this webhook will be added to SMS Eagle config for terminating SMS.

What is hardware
SMS Gateway?

Learn more about
SMSEagle features

Explore SMSEagle Demo device

SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.

After registering to a demo you get a remote access to our physical device NXS-9750.

  • 14-days free trial
  • Access to over 20 functionalities