FAQ

IXICA SMS/MMS and 3CX integration

IXICA · Integration FAQ

How do I integrate IXICA SMS/MMS with 3CX?

Connect your IXICA mysms account to 3CX by exchanging the API key and two URLs. Follow the field mapping below to put each value in the correct system.

Important: Use the IXICA mysms API Key for 3CX. Do not use the Secret Key. All credentials and account-specific URLs shown in this guide have been masked. Copy the real values from your own account, not from these screenshots.

Which fields go where?

Copy from Paste into Purpose
IXICA My Account → API Key 3CX SMS → API Key The mysms API key used for this integration.
3CX SMS → Webhook IXICA My Account → API Webhook URL (SMS) The 3CX-side webhook URL belongs in IXICA.
IXICA My Account → Callback url 3CX SMS → Provider URL The IXICA callback URL belongs in 3CX.
IXICA My Account → Webhook Type Select 3CX in IXICA Choose the integration type.
IXICA My Account → Secret Key Not used Do not enter this value in 3CX.

Remember the direction: the 3CX Webhook goes to IXICA; the IXICA Callback URL goes to 3CX.

How do I configure the integration?

STEP 1Open My Account in IXICA

Sign in to the IXICA mysms portal. Click the letter/profile icon in the upper-right corner, then select My Account.

mysms menu my accountSelect My Account from the profile menu.

STEP 2Locate your IXICA integration values

On the My Account page, locate the API Key and Callback url. Keep this page open—you will copy both values into 3CX and return here to finish the webhook settings.

mysms accountIXICA My Account. API keys and endpoint URLs are redacted; field labels remain visible.

Use API Key, not Secret Key. The API Key shown on this page is the mysms API key that belongs in the 3CX API Key field. You do not need the Secret Key for this setup.

STEP 3Enter the IXICA values in 3CX

  1. Open the relevant IXICA configuration in 3CX and select the SMS tab shown below.
  2. Select Enable SMS.
  3. Copy the IXICA mysms API Key into the 3CX API Key field.
  4. Copy the IXICA Callback url into the 3CX Provider URL field.
  5. Copy the Webhook value displayed in 3CX. Use the copy icon beside it if available.

3cx sms3CX SMS configuration. Copy the Webhook to IXICA; paste the IXICA API Key and Callback URL into the two input fields.

STEP 4Finish the webhook settings in IXICA

  1. Return to My Account in IXICA.
  2. Paste the webhook you copied from 3CX into API Webhook URL (SMS).
  3. Set Webhook Type to 3CX.
  4. Click Save in IXICA. Save or apply your changes in 3CX as well.

STEP 5Test messaging in both directions

Send a test SMS from 3CX to a mobile phone, then reply from the phone and confirm that the reply appears in 3CX. If you intend to use MMS, also test an image message in each direction using the numbers and clients you plan to use.

MMS scope: These screenshots document the configuration fields, not a separate MMS setup or a compatibility guarantee. Confirm MMS availability for your IXICA service and 3CX environment before relying on it.

Common questions

Which API key should I use?

Use the API Key on IXICA’s My Account page. This is the mysms API key. Paste it into API Key on the 3CX SMS configuration page.

Do I need the Secret Key?

No. Do not use the IXICA Secret Key for this 3CX configuration. It is not a substitute for the API Key.

Where do I enter the webhook from 3CX?

Paste the 3CX Webhook into IXICA’s API Webhook URL (SMS) field. Then select 3CX as the Webhook Type and save.

What goes in 3CX’s Provider URL field?

The Callback url from IXICA’s My Account page. Do not paste the 3CX Webhook into Provider URL.

What should Webhook Type be set to?

Select 3CX in IXICA.

Do I need to change Enable Caller ID Number Matching?

That option appears in the supplied 3CX screenshot, but no required setting was provided for this integration. This FAQ does not instruct you to enable it or change its digit count.

What should I check if a test message fails?

  • Start with the mapping table. Confirm that the API Key and Callback URL were copied from the same IXICA account you are configuring.
  • Check the 3CX fields: Enable SMS is selected; API Key contains the IXICA mysms API Key, not the Secret Key; Provider URL contains the IXICA Callback URL.
  • Check the IXICA fields: API Webhook URL (SMS) contains the webhook from the correct 3CX configuration, and Webhook Type is set to 3CX.
  • Re-copy complete values without leading or trailing spaces, then save changes in both systems and repeat the test.
  • If the issue persists, contact your administrator or IXICA support with the direction of the failed test, its time, and any error shown. Keep API keys, secrets and private webhook URLs out of public screenshots.

Final setup checklist

  • IXICA mysms API Key → 3CX API Key.
  • IXICA Callback URL → 3CX Provider URL.
  • 3CX Webhook → IXICA API Webhook URL (SMS).
  • IXICA Webhook Type → 3CX.
  • 3CX Enable SMS → selected.
  • Secret Key → not used.
  • Changes saved in both systems.
  • Outbound and inbound messaging tested; MMS tested separately if needed.
Based on the supplied IXICA and 3CX screenshots and integration instructions. Interface labels and navigation may differ in other versions. Screenshots are sanitized for instructional use; this guide does not establish version-specific or MMS compatibility requirements.

Share

Back to all FAQ answers