Mobile Message 3CX SMS Integration Guide

Yes - Mobile Message does integrate with 3CX!

Mobile Message is an Australian‑based SMS gateway that lets you send and receive texts programmatically. This guide demonstrates how to connect it to 3CX using the built‑in Generic Trunk connector. Once configured, agents can exchange SMS directly from the 3CX Web or Desktop Client; inbound messages flow back into the same chat thread—no middleware or CFD flows required.

Prerequisites

To set up this integration you’ll need:

• A 3CX Hosted licence with BYO (generic) trunks — available on Pro and Enterprise tiers. Hosted-Free users must either upgrade or self-host to access the Generic connector.
• A Mobile Message account — sign up at https://mobilemessage.com.au/.
• Your API credentials — located in Settings → API within the Mobile Message portal.
• A dedicated SMS number — Get your dedicated number in Settings → Sender IDs for two-way texting.
• Firewall egress (self hosted only) — ensure outbound TCP 443 traffic to api.mobilemessage.com.au is allowed.

Collect your Mobile Message Credentials

1. Log in to https://app.mobilemessage.com.au/.
2. Navigate to Settings → API.
3. Click Create API Key (if you don’t already have one).
4. Copy the API Username and API Password—keep them safe.

Create the Generic Trunk in 3CX

Add the Trunk Shell

1. Admin → Voice & Chat → + Add Trunk.
2. Country select Worldwide / Generic (type Generic in the search box if it’s not visible).
3. Provider / Trunk Template choose Generic SIP Trunk.
4. Main Trunk Number enter any of your Mobile Message virtual numbers in E.164 format, e.g. +61412345678.
5. Complete the wizard. 3CX creates the trunk and returns you to the list.

Enable Messaging & Enter Provider Details

1. Re-open the trunk and switch to the SMS tab.
2. Toggle Enable Messaging.
3. Enter the following details:
   • Provider URL: https://api.mobilemessage.com.au/3cx/send-sms
   • API Key: username:password (from step 3) — Enter your API username, then a colon, followed immediately by your API password. For example, if your username is abc123 and your password is mysecurepass12345, you would enter abc123:mysecurepass12345.
4. Copy the Webhook URL shown on the page (e.g. https://<pbx>.au.3cx.cloud:5001/webhook-xxxxxxxx).
5. Click Save.

Register the Webhook with Mobile Message

Mobile Message must know where to deliver inbound texts.

1. Email hello@mobilemessage.com.au with subject “3CX Webhook”.
2. Include your copied Webhook URL and your Mobile Message account email/company.
3. Our team will confirm activation (usually within one business hour).

Test the Flow

1. From any personal mobile, send “test” to your new Mobile Message number.
2. A chat should appear in the 3CX Web Client within ~2 seconds.
3. Reply “hello” from 3CX and verify the handset receives it.

Frequently Asked Questions

Q. Can I use my landline number as the Sender ID?
No. Australian landline numbers cannot originate SMS. Use an alphanumeric Sender ID (max 11 chars) or a Mobile Message virtual mobile number.

Q. Does this work for international SMS?
Mobile Message currently supports Australian (+61) mobiles only.

Q. Do I need a paid 3CX licence?
Hosted by 3CX: Yes—only Pro/Enterprise tiers expose the Generic connector.
Self‑Hosted PBX: The Free key unlocks Generic; alternatively, some built‑in provider templates on Hosted‑Free expose SMS Provider URL & API Key fields that accept the same values shown above.