BG TEL SMS for WordPress

The official, dependency-free WordPress integration for the BG TEL SMS API. Send SMS from the WordPress dashboard or integrate messaging into your own plugin with a small PHP API.

Features

• Send one message to one or many recipients.
• Send personalized messages to multiple recipients.
• Send transactional and promotional SMS.
• Check account balance from WordPress.
• Retrieve delivery reports by request ID.
• Review privacy-safe SMS logs with charges, balances, request IDs, and delivery status.
• Provide rate-limited OTP login and optional customer registration with [bgtel_sms_otp].
• Normalize local and international phone numbers.
• Detect Unicode messages automatically.
• Extend outgoing requests with WordPress hooks.
• Migrate credentials from the earlier WooCommerce integration.

Requirements

• WordPress 6.2 or newer
• PHP 7.4 or newer
• A BG TEL SMS account code, API key, and approved sender ID

Installation

1. Download bgtel-sms.zip.
2. In WordPress, open Plugins > Add New > Upload Plugin.
3. Select the ZIP, install it, and activate BG TEL SMS.
4. Open BG TEL SMS > Settings.
5. Save your account code, API key, sender ID, and messaging defaults.
6. Select Test connection / check balance.

SMS activity appears under BG TEL SMS > SMS Logs. To offer passwordless login, enable OTP in settings and place [bgtel_sms_otp] on a public page.

See the User Guide for configuration, sending, and troubleshooting.

Developer quick start

$result = bgtel_sms_send(
    '+8801XXXXXXXXX',
    'Your verification code is 123456.'
);

if ( is_wp_error( $result ) ) {
    error_log( $result->get_error_message() );
}

The function accepts a single phone number or an array of numbers. Successful calls return the decoded BG TEL API response; failures return WP_Error.

bgtel_sms_send(
    array( '017XXXXXXXX', '018XXXXXXXX' ),
    'We are open today.'
);

For personalized messages, balance checks, delivery reports, filters, and actions, see the Developer Guide.

API coverage

Requests use the production endpoints documented by BG TEL SMS.

Security

• Only administrators with manage_options can configure credentials or send from the dashboard.
• The API key is never rendered back into the settings form.
• Credentials are sent only to https://apipro.bgtelsms.com over HTTPS.
• Logs mask recipients and never store message content or credentials.
• OTP codes are hashed, expire after five minutes, allow five attempts, and are rate-limited by phone and IP address.
• Do not commit credentials, print API payloads, or expose send functions through an unauthenticated endpoint.

WordPress stores the settings in its options table. Protect database backups and restrict administrator access.

Testing

Run the dependency-free smoke check with PHP 7.4 or newer:

php -d zend.assertions=1 -d assert.exception=1 tests/smoke.php

The release ZIP has also been tested by installing and activating it in an isolated WordPress and MariaDB Docker environment.

Support

• BG TEL SMS website
• API documentation
• GitHub issues

When reporting a problem, include the WordPress and PHP versions plus the API error message. Never include the API key.

License

GPL-2.0-or-later. See the GNU General Public License version 2.