# Voxtelesys SMS Integration
Before proceeding with the next steps, you need to [purchase a DID on the Voxtelesys platform](/portsip-communications-solution/configuring-sip-trunks/voxtelesys-sip-trunk/purchase-a-did-on-questblue-platform.md) with SMS/MMS enabled.
***
### Create a Voxtelesys API Key
To enable **SMS/MMS sending** from PortSIP PBX, you must create a **Voxtelesys API key**.
#### Step 1: Generate the API Key
1. Sign in to the [Voxtelesys Portal](https://portal.voxtelesys.net/).
2. Navigate to **API Keys > Keys**.
3. Click **Create Key**.
4. Copy the generated **API key** and store it securely.
> ❗**Important**\
> The API key is required later when configuring SMS/MMS in PortSIP PBX.\
> Treat it as a sensitive credential. If the key is compromised, revoke it and create a new one immediately.
***
### Configure SMS with Voxtelesys Trunk in PortSIP PBX
Before configuring SMS in PortSIP PBX, ensure that a Voxtelesys SIP trunk has already been configured using one of the following guides:
* [Configuring Voxtelesys Register Based Trunk](/portsip-communications-solution/configuring-sip-trunks/voxtelesys-sip-trunk/configuring-questblue-register-authentication-trunk.md)
* [Configuring Voxtelesys IP-Based Trunk](/portsip-communications-solution/configuring-sip-trunks/voxtelesys-sip-trunk/configuring-questblue-ip-authentication-trunk.md)
Once the SIP trunk is ready, you can proceed with the SMS/MMS configuration in PortSIP PBX.
***
### Sign in to the PortSIP PBX Web Portal
You can access the tenant configuration using one of the following methods:
#### Option 1: Sign in as System Administrator
1. Sign in to the PortSIP PBX Web Portal as a **System Administrator**.
2. Navigate to **Tenants**.
3. Select the desired tenant and click **Manage** to switch to that tenant’s administration context.
#### Option 2: Sign in as Tenant Administrator
* Sign in directly as a **Tenant Administrator** to manage the tenant.
> ❗**Note**\
> For more information about tenant roles and permissions, refer to [Tenant Management](/portsip-communications-solution/portsip-pbx-administration-guide/3-tenant-management.md).
***
### Add an SMS Configuration in PortSIP PBX
To enable SMS/MMS using the **Voxtelesys trunk**, you must create an SMS configuration in PortSIP PBX.
***
#### Step 1: Create the SMS Configuration
1. In the PortSIP PBX Web Portal, navigate to **SMS/MMS** from the left-hand menu.
2. Click **Add**.
3. Select your configured **Voxtelesys trunk**.
4. Configure the following fields:
* **Sender ID**
* Optional.
* Leave this field empty unless Voxtelesys has explicitly enabled and provided a Sender ID for your account.
* **API Key**
* Paste the **Voxtelesys API Key** you created earlier.
5. Click **OK** to save the configuration.
***
#### Step 2: Copy the Webhook URL
6. After saving, you will be redirected to the **SMS/MMS list** page.
7. Obtain the **Webhook URL** using one of the following methods:
* Select the SMS configuration and click **Copy Webhook**.
* Or, double-click the SMS configuration to open its details page, then copy the **Webhook URL** from there.
> ❗**Important**\
> The Webhook URL is required for Voxtelesys to deliver **inbound SMS/MMS messages** to PortSIP PBX.\
> You will configure this URL on the Voxtelesys side in the next step.
***
### Configure SMS in Voxtelesys
After creating the SMS configuration in PortSIP PBX, you must configure **Voxtelesys** to deliver inbound SMS/MMS messages to PortSIP PBX.
***
#### Step 1: Create a Messaging Application
1. Sign in to the [Voxtelesys Portal](https://portal.voxtelesys.net/).
2. Navigate to **APIs > Messaging Applications**.
3. Click **Create Application**.
4. Configure the application with the following values:
* **Profile Name**: `PortSIP SMS`
* **Trunk Group**:
* Select the **same trunk group** associated with the API key you created earlier.
* **HTTP Method**: `POST`
* **Events**: `Inbound Messages (MOs)`
* **MO Webhook**:
* Paste the **PortSIP PBX Webhook URL** you copied in the previous steps.
* **Authentication**: `None`
5. Click **Save** to create the messaging application.
***
#### Step 2: Enable SMS on the DID Number
1. Navigate to **Phone Numbers > Numbers**.
2. Click the **pencil (Edit)** icon next to the DID number that will receive SMS messages.
3. In the pop-up window, configure the following settings:
* **SMS Enabled**: ✔ Enable
* **Service Trunk**: `SMS | Fax2Email`
* **Messaging Application**: `PortSIP SMS`
* **Campaign**:
* Select the appropriate campaign value based on your compliance requirements.
4. Click **Confirm** to save the changes.
Your Voxtelesys SMS integration with PortSIP PBX is now complete.
***
#### Additional Notes and Best Practices
* Ensure the DID number (with SMS enabled) is assigned to the correct user or extension in PortSIP PBX.
* Inbound SMS routing in PortSIP PBX follows the same inbound rules logic as voice calls.
* Number Format Requirement:
* PortSIP PBX supports SMS in E.164 format.
* Ensure:
* DID numbers in PortSIP PBX are configured in E.164 format.
* The Voxtelesys Messaging Application uses E.164.
* The Inbound Trunk on Voxtelesys is also configured for E.164.
> ❗**Best Practice**\
> Using E.164 formatting consistently avoids delivery failures and ensures correct sender/recipient matching across SIP trunks and messaging platforms.
***
### Verify Configuration
You can now [create Outbound and Inbound Rules](/portsip-communications-solution/configuring-sip-trunks/voxtelesys-sip-trunk/configuring-outbound-and-inbound-calls.md) in PortSIP PBX for sending and receiving SMS/MMS using the Voxtelesys trunk, exactly the same way you configure rules for voice calls.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://support.portsip.com/portsip-communications-solution/configuring-sip-trunks/voxtelesys-sip-trunk/voxtelesys-sms-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.