Home / Integration plugins / 3CX SMS Integration

+

Send and receive SMS in 3CX

Connect SMSEagle to 3CX as an SMS trunk. Your agents send and receive SMS in the 3CX client, through your own SIM card, with no SMS provider subscription.

No third-party SMS gateway subscription

3CX’s SMS feature normally needs a paid SMS gateway provider. SMSEagle plugs in as a Generic VoIP Provider trunk using its own API, so 3CX gets two-way SMS without a recurring SMS subscription.

Replies can be routed back into 3CX

The trunk works both directions: agents send SMS from the 3CX client, and inbound replies are delivered back to 3CX through a callback URL, so a text conversation stays inside the same client agents already use for calls.

Runs on your own SIM and hardware

Messages go out through SMSEagle’s own cellular connection, so SMS delivery doesn’t depend on a third party’s uptime or pricing.

How it works

1

SMS sent from 3CX

An agent sends an SMS from the 3CX client, addressed through the trunk configured for SMSEagle.

2

API call to SMSEagle

3CX calls SMSEagle’s API directly with the API key generated on SMSEagle, and SMSEagle sends the SMS over its own SIM.

3

Replies routed back

An incoming SMS reply triggers SMSEagle’s Webhooks rule, which posts it to the 3CX webhook so the reply appears back in the same 3CX conversation.

Set up in about 10 minutes

No separate SMS gateway subscription to buy. With an API token from SMSEagle and a Generic VoIP Provider trunk in 3CX, two-way SMS is live in the 3CX client in about 10-15 minutes, on Professional and Enterprise (self-hosted) licenses.

SMSEagle gives 3CX two-way SMS through your own SIM card, with no SMS provider in between.

You only pay for your SIM plan

SMS are sent through the SIM card in your SMSEagle, so there are no per-message fees from an SMS provider, only your mobile plan.

Customer data stays in the company

Conversations with customers go from 3CX to your own device and straight to the mobile network, with no external SMS service in between.

Works with 3CX Professional and Enterprise (self-hosted)

The SMS trunk is available on 3CX Professional and Enterprise licenses installed on your own server.

SMSEagle configuration

  1. Create a new user in SMSEagle (menu System > Users, user access level: “User”).
  2. Create an API key for that user:
    • go to Settings > Global settings > API and open the API v2 page.
    • click Create API key, fill in Key name and select the user created above as Owner.
    • Add access permissions in section External for: Forward a message from 3CX system.
    • Click Create key.
    • The access token is shown only once, right after saving – copy it and paste it on API Key field on the trunk where the number resides.
  3. On menu go to Automation > General > Webhooks and click Create new:
    • In the Rule name field put a descriptive name e.g. 3CX System.
    • Under URL field paste the 3CX webhook URL generated from 3CX Setup
    • Click Test connection next to the URL field to check the endpoint before saving.
    • In the URL method field chose: POST (3CX)
    • On the To (3CX) put the number that the messages will be terminated to as per 3CX config
    • And click Save webhook.

3CX configuration

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 Settings > Global settings > API > API v2 > Create API key.
    • 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.

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

What is hardware
SMS Gateway?

Learn more about
SMSEagle features