SMS Notifications

The SMS Notifications function sends SMS text messages when Voxel app events occur. This provides instant mobile notifications for critical events like new orders, submissions, or messages.

Overview

Extend Voxel’s notification system beyond email and in-app notifications to include SMS. Configure which events trigger SMS and customize messages with dynamic tags. Supports multiple SMS providers.

Key Features

• SMS notifications for all Voxel app events
• Multiple provider support (Twilio, Vonage, MessageBird, Telnyx, Solapi)
• Per-event SMS configuration
• Dynamic tags in SMS messages
• International phone number support
• Test SMS functionality
• Enhanced phone input with country code detection

Setup Instructions

Step 1: Enable the Function

1. Navigate to Voxel Toolkit → Functions in your WordPress admin
2. Find SMS Notifications in the list
3. Toggle the switch to enable the function
4. Click Save Changes

Step 2: Configure SMS Provider

Choose and configure your SMS provider:

Twilio

1. Sign up at twilio.com
2. Get your Account SID and Auth Token from the console
3. Purchase a phone number for sending SMS
4. Enter credentials in Voxel Toolkit settings

Vonage (Nexmo)

1. Sign up at vonage.com
2. Get your API Key and API Secret
3. Configure a sender ID or phone number
4. Enter credentials in Voxel Toolkit settings

MessageBird

1. Sign up at messagebird.com
2. Get your API Key
3. Configure an originator (sender name or number)
4. Enter credentials in Voxel Toolkit settings

Telnyx (New in 1.6.1)

Telnyx is a global telecommunications provider with competitive SMS rates and reliable delivery worldwide.

1. Sign up at telnyx.com
2. Purchase a phone number in the Mission Control Portal
3. Generate an API v2 key under API Keys section
4. Enter your API Key and From Number in Voxel Toolkit settings

Solapi (New in 1.6.1)

Solapi is a Korean SMS provider optimized for the Korean market with local phone number support and regulatory compliance.

1. Sign up at solapi.com
2. Verify your account and business information
3. Register a sender phone number
4. Generate API credentials (API Key and API Secret) in the console
5. Enter your API Key, API Secret, and From Number in Voxel Toolkit settings

Step 3: Configure Phone Number Field

Select which Voxel profile field contains user phone numbers:

1. In the Phone Field setting, select the profile field that stores phone numbers
2. Set a default Country Code for numbers without international prefix

Step 4: Configure Event SMS

Configure SMS for each event in Voxel → App Events:

1. Navigate to any event configuration
2. You’ll see an SMS toggle for each notification destination
3. Enable SMS and enter your message template
4. Use dynamic tags to personalize messages

Provider Configuration

Provider	Required Settings	Best For
Twilio	Account SID, Auth Token, From Number	Global coverage, popular choice
Vonage	API Key, API Secret, From Name/Number	Enterprise, international
MessageBird	API Key, Originator	European markets
Telnyx	API Key, From Number	Cost-effective global SMS
Solapi	API Key, API Secret, From Number	Korean market

Dynamic Tags

SMS messages support Voxel’s dynamic tags. Available tags depend on the event type. Common tags include:

• @user(display_name) – User’s display name
• @post(title) – Post/listing title
• @order(id) – Order ID
• @site(name) – Site name

Example SMS Templates

New listing submitted: @post(title) - Review at @site(url)

Order #@order(id) received from @user(display_name). Total: @order(total)

New message from @user(display_name) regarding @post(title)

International Phone Support

The function includes enhanced international phone number handling:

• Country Code Detection: Automatically detects and stores country codes
• E.164 Format: Normalizes numbers to international format
• Default Country: Falls back to configured default country
• Enhanced Input: Provides intl-tel-input integration for phone fields

Solapi Phone Format Note

Solapi uses Korean phone number format. The provider automatically handles format conversion – international format (+821012345678) is converted to local format for sending.

Testing SMS

Before going live, test your SMS configuration:

1. In the SMS Notifications settings, find the Test SMS section
2. Enter a phone number to receive the test
3. Click Send Test SMS
4. Verify the message arrives correctly

Use Cases

Order Notifications

Instantly notify vendors when they receive new orders.

Booking Alerts

Alert hosts immediately when bookings are made.

Admin Alerts

Get critical notifications via SMS when you’re away from email.

Customer Updates

Send order confirmations and status updates directly to customers’ phones.

Korean Market (Solapi)

Reach Korean customers with locally compliant SMS using Solapi’s Korean infrastructure.

Troubleshooting

SMS Not Sending

• Verify provider credentials are correct
• Check that the phone field is configured
• Ensure recipient has a valid phone number in their profile
• Verify event SMS is enabled in App Events
• Check provider account balance and limits

Invalid Phone Number Errors

• Ensure country code is configured correctly
• Check that phone numbers include country prefix or default is set
• Verify phone number format matches provider requirements

Test SMS Works But Events Don’t

• Enable SMS for the specific event in App Events
• Check that the notification destination (customer/vendor/admin) is configured
• Verify the event is actually triggering (check email notifications)

Telnyx Authentication Failed

• Verify you’re using an API v2 key (starts with KEY…)
• Check that the key has SMS permissions
• Ensure account balance is sufficient

Solapi Authentication Failed

• Verify both API Key and API Secret are correct
• Check server time is synchronized (HMAC authentication is time-sensitive)
• Ensure sender number is registered and approved in Solapi console

Requirements

• Voxel Theme (active and configured)
• Voxel Toolkit plugin (enabled)
• SMS provider account (Twilio, Vonage, MessageBird, Telnyx, or Solapi)
• Phone number field in user profiles