Purpose

This guide provides step-by-step instructions for configuring SMS services on a Yeastar PBX using IXICA’s SMS platform. It is intended for system administrators and IT professionals responsible for PBX configuration and messaging enablement.

Prerequisites

Before you begin, ensure the following requirements are met:

  • An active Yeastar PBX (software or hardware) with administrative access

  • A valid IXICA SIPControl account

  • SMS service ordered and provisioned by IXICA

  • Access to the IXICA SMS portal (ww2.mysms.ca)

  • Yeastar Linkus Desktop or Mobile App installed (for end-user testing)

High-Level Workflow

  1. Order SMS service from IXICA

  2. Receive IXICA SMS portal credentials

  3. Secure the SMS portal account

  4. Create an SMS channel in Yeastar PBX

  5. Configure webhook and API credentials in the IXICA SMS portal

  6. Complete SMS channel configuration in Yeastar

  7. Assign numbers and permissions

  8. Test SMS functionality using Linkus

Step 1: Order SMS from IXICA

  1. Log in to IXICA SIPControl.

  2. Order SMS service for the required DID(s).

  3. Wait for the confirmation email from IXICA containing:

    • SMS portal URL

    • Username

    • Temporary password

Note: SMS provisioning must be completed by IXICA before configuration can proceed.

Step 2: Secure Your IXICA SMS Portal Account

  1. Navigate to https://ww2.mysms.ca.

  2. Log in using the credentials provided by IXICA.

  3. In the top-right corner, select Account.

  4. Scroll to the bottom of the page and change the password.

  5. Save the updated credentials securely.

Step 3: Create an SMS Channel in Yeastar PBX

  1. Log in to the Yeastar PBX Admin Portal.

  2. Navigate to: Message → Message Channel

  3. Click Add.

  4. Select SMS as the channel type.

  5. Choose ITSP: IXICA.

Yeastar will automatically generate a Webhook (Callback) URL.

Keep this page open, as the Webhook URL will be required in the next step.

Step 4: Configure Webhook and API Credentials in IXICA SMS Portal

  1. Return to https://ww2.mysms.ca.

  2. Paste the Webhook URL copied from Yeastar into the appropriate field.

  3. Generate or enter:

    • API Key

    • Secret Key

  4. Set Webhook Type to: Yeastar

  5. Click Save.

This establishes secure, bidirectional communication between IXICA and Yeastar.

Step 5: Complete SMS Channel Configuration in Yeastar

  1. Return to the Yeastar PBX → Message Channel configuration.

  2. Paste the following values obtained from the IXICA SMS portal:

    • API Key

    • Secret Key

    • Callback (Webhook) URL (if required by your Yeastar version)

  3. Click Save.

Step 6: Configure Message Settings

  1. In Yeastar, navigate to the Message Settings tab for the SMS channel.

  2. Configure the following:

    • Number: The SMS-enabled DID

    • Inbound Destination: Extension, ring group, or queue for inbound SMS

    • Allowed Extensions: Extensions permitted to send SMS

  3. Click Save.

Step 7: Test SMS Functionality

Outbound Test (Linkus App)

  1. Open the Linkus App.

  2. Go to: Chat → External → +

  3. Create a new SMS session.

  4. Enter the mobile number in +E.164 format (e.g. +14162734828).

  5. Click Create and send a test message.

Inbound Test

  1. Send an SMS from a mobile phone to the SMS-enabled DID.

  2. Confirm the message is delivered to the configured destination in Linkus.

Troubleshooting Tips

  • No inbound SMS: Verify webhook URL, firewall rules, and correct webhook type (Yeastar).

  • Outbound SMS fails: Confirm API Key/Secret Key accuracy and extension permissions.

  • Linkus not showing SMS: Ensure the user is logged in with an allowed extension and messaging is enabled.

If issues persist, collect screenshots and logs and escalate to IXICA NOC with the affected DID and timestamps.

Support

For provisioning or platform-related issues:

For Yeastar PBX configuration issues:

  • Refer to Yeastar official documentation or your system integrator.