BSB Messaging API

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        
        var values = new Dictionary<string, string>
        {
            { "api_key", "your-api-key-here" },
            { "api_secret", "your-api-secret-here" },
            { "senderid", "SENDERID" },
            { "destination", "96170123456" },
            { "message", "Hello, this is a test SMS!" }
        };

        var content = new FormUrlEncodedContent(values);
        var response = await client.PostAsync(
            "https://www.bestsmsbulk.com/bestsmsbulkapi/sendSmsAPI.php", 
            content
        );

        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

import requests

url = "https://www.bestsmsbulk.com/bestsmsbulkapi/sendSmsAPI.php"

data = {
    "api_key": "your-api-key-here",
    "api_secret": "your-api-secret-here",
    "senderid": "SENDERID",
    "destination": "96170123456",
    "message": "Hello, this is a test SMS!"
}

response = requests.post(url, data=data)
print(response.text)
# Response: confirmationID;recipientNumber;numSMSParts

const https = require('https');
const querystring = require('querystring');

const postData = querystring.stringify({
    api_key: 'your-api-key-here',
    api_secret: 'your-api-secret-here',
    senderid: 'SENDERID',
    destination: '96170123456',
    message: 'Hello, this is a test SMS!'
});

const options = {
    hostname: 'www.bestsmsbulk.com',
    path: '/bestsmsbulkapi/sendSmsAPI.php',
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Content-Length': Buffer.byteLength(postData)
    }
};

const req = https.request(options, (res) => {
    let data = '';
    res.on('data', chunk => data += chunk);
    res.on('end', () => console.log('Response:', data));
});

req.write(postData);
req.end();

import requests

url = "https://www.bestsmsbulk.com/bestsmsbulkapi/sendSmsAPIJson.php"

# JSON array - can send multiple messages at once
data = [
    {
        "api_key": "your_api_key",
        "api_secret": "your_api_secret",
        "senderid": "SENDERID",
        "destination": "96170123456",
        "message": "Hello, this is message 1!"
    },
    {
        "api_key": "your_api_key",
        "api_secret": "your_api_secret",
        "senderid": "SENDERID",
        "destination": "96170789012",
        "message": "Hello, this is message 2!"
    }
]

response = requests.post(url, json=data)
print(response.json())

const https = require('https');

// JSON array - can send multiple messages at once
const data = JSON.stringify([
    {
        api_key: 'your_api_key',
        api_secret: 'your_api_secret',
        senderid: 'SENDERID',
        destination: '96170123456',
        message: 'Hello, this is message 1!'
    },
    {
        api_key: 'your_api_key',
        api_secret: 'your_api_secret',
        senderid: 'SENDERID',
        destination: '96170789012',
        message: 'Hello, this is message 2!'
    }
]);

const options = {
    hostname: 'www.bestsmsbulk.com',
    path: '/bestsmsbulkapi/sendSmsAPIJson.php',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(data)
    }
};

const req = https.request(options, (res) => {
    let body = '';
    res.on('data', chunk => body += chunk);
    res.on('end', () => console.log(JSON.parse(body)));
});

req.write(data);
req.end();

import requests

url = "https://www.bestsmsbulk.com/bestsmsbulkapi/getSmsStatusJson.php"

# JSON array format required
data = [
    {
        "api_key": "your_api_key",
        "api_secret": "your_api_secret",
        "limit": 100
    }
]

response = requests.post(url, json=data)
statuses = response.json()
print(statuses)

const https = require('https');

// JSON array format required
const data = JSON.stringify([
    {
        api_key: 'your_api_key',
        api_secret: 'your_api_secret',
        limit: 100
    }
]);

const options = {
    hostname: 'www.bestsmsbulk.com',
    path: '/bestsmsbulkapi/getSmsStatusJson.php',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(data)
    }
};

const req = https.request(options, (res) => {
    let body = '';
    res.on('data', chunk => body += chunk);
    res.on('end', () => console.log(JSON.parse(body)));
});

req.write(data);
req.end();

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        
        var values = new Dictionary<string, string>
        {
            { "api_key", "your_api_key" },
            { "api_secret", "your_api_secret" },
            { "templateName", "order_confirmation" },
            { "templateCategory", "UTILITY" },
            { "bodyText", "Hi {{1}}, your order #{{2}} has been confirmed." },
            { "bodyExample", "John,12345" },  // Required when using variables
            { "footerText", "Thank you for your order!" },
            { "button1type", "URL" },
            { "button1text", "Track Order" },
            { "button1url", "https://example.com/track" }
        };

        var content = new FormUrlEncodedContent(values);
        var response = await client.PostAsync(
            "https://www.bestsmsbulk.com/bestsmsbulkapi/common/submitMetaTemplateAPI.php",
            content
        );

        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine($"Status: {response.StatusCode}");
        Console.WriteLine($"Response: {result}");
    }
}

import requests

url = "https://www.bestsmsbulk.com/bestsmsbulkapi/common/submitMetaTemplateAPI.php"

# For template with image header, use multipart/form-data
files = {
    'headerMedia': ('promo.jpg', open('/path/to/promo.jpg', 'rb'), 'image/jpeg')
}

data = {
    "api_key": "your_api_key",
    "api_secret": "your_api_secret",
    "templateName": "summer_promo",
    "templateCategory": "MARKETING",
    "headerType": "IMAGE",  # IMAGE, VIDEO, or DOCUMENT
    "bodyText": "Hi {{1}}! Check out our summer sale with up to {{2}}% off!",
    "bodyExample": "valued customer,50",  # Required when using variables
    "footerText": "Limited time offer",
    "button1type": "URL",
    "button1text": "Shop Now",
    "button1url": "https://example.com/sale"
}

response = requests.post(url, data=data, files=files)
print(response.json())

# For text-only template (no media), simpler request:
# response = requests.post(url, data=data)

const https = require('https');
const querystring = require('querystring');

// Authentication template (OTP)
const postData = querystring.stringify({
    api_key: 'your_api_key',
    api_secret: 'your_api_secret',
    templateName: 'login_otp',
    templateCategory: 'AUTHENTICATION',
    bodyText: '{{1}} is your verification code. Valid for {{2}} minutes.',
    bodyExample: '123456,5'  // Required when using variables
    // Note: AUTHENTICATION templates automatically get a "Copy Code" button
});

const options = {
    hostname: 'www.bestsmsbulk.com',
    path: '/bestsmsbulkapi/common/submitMetaTemplateAPI.php',
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Content-Length': Buffer.byteLength(postData)
    }
};

const req = https.request(options, (res) => {
    let data = '';
    res.on('data', chunk => data += chunk);
    res.on('end', () => {
        console.log('Status:', res.statusCode);
        console.log('Response:', JSON.parse(data));
    });
});

req.write(postData);
req.end();

# Text template with variables
curl -X POST "https://www.bestsmsbulk.com/bestsmsbulkapi/common/submitMetaTemplateAPI.php" \
  -d "api_key=your_api_key" \
  -d "api_secret=your_api_secret" \
  -d "templateName=welcome_message" \
  -d "templateCategory=MARKETING" \
  -d "bodyText=Welcome {{1}}! Thanks for joining us." \
  -d "bodyExample=John" \
  -d "footerText=We are glad to have you!"

# Template with IMAGE header (use -F for multipart/form-data)
curl -X POST "https://www.bestsmsbulk.com/bestsmsbulkapi/common/submitMetaTemplateAPI.php" \
  -F "api_key=your_api_key" \
  -F "api_secret=your_api_secret" \
  -F "templateName=product_launch" \
  -F "templateCategory=MARKETING" \
  -F "headerType=IMAGE" \
  -F "headerMedia=@/path/to/image.jpg" \
  -F "bodyText=Introducing our new product: {{1}}" \
  -F "bodyExample=Summer Collection" \
  -F "button1type=URL" \
  -F "button1text=Learn More" \
  -F "button1url=https://example.com/product"

# Template with VIDEO header
curl -X POST "https://www.bestsmsbulk.com/bestsmsbulkapi/common/submitMetaTemplateAPI.php" \
  -F "api_key=your_api_key" \
  -F "api_secret=your_api_secret" \
  -F "templateName=video_promo" \
  -F "templateCategory=MARKETING" \
  -F "headerType=VIDEO" \
  -F "headerMedia=@/path/to/video.mp4" \
  -F "bodyText=Watch our latest video!"

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        
        // Add required API-Secured-Key header
        client.DefaultRequestHeaders.Add("API-Secured-Key", "YOUR_API_SECURED_KEY_HERE");
        
        var data = new
        {
            api_key = "your-api-key-here",
            api_secret = "your-api-secret-here",
            destination = "96170123456",
            message = "Hello from Secured API!",
            route = "wp",
            template = "your_template",
            variables = "var1,var2"
        };

        var json = JsonSerializer.Serialize(data);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        
        var response = await client.PostAsync(
            "https://www.bestsmsbulk.com/bestsmsbulkapi/common/messaging_api_secured_json.php",
            content
        );

        Console.WriteLine($"Status: {response.StatusCode}");
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

import requests
import json

url = "https://www.bestsmsbulk.com/bestsmsbulkapi/common/messaging_api_secured_json.php"

headers = {
    "Content-Type": "application/json",
    "API-Secured-Key": "YOUR_API_SECURED_KEY_HERE"  # Required! From API Keys & Secrets
}

data = {
    "api_key": "your-api-key-here",
    "api_secret": "your-api-secret-here",
    "destination": "96170123456",
    "message": "Hello from Secured API!",
    "route": "wp",
    "template": "your_template",
    "variables": "var1,var2"
}

response = requests.post(url, json=data, headers=headers)

print(f"Status Code: {response.status_code}")
print(f"Response: {response.json()}")

const https = require('https');

const data = JSON.stringify({
    api_key: 'your-api-key-here',
    api_secret: 'your-api-secret-here',
    destination: '96170123456',
    message: 'Hello from Secured API!',
    route: 'wp',
    template: 'your_template',
    variables: 'var1,var2'
});

const options = {
    hostname: 'www.bestsmsbulk.com',
    path: '/bestsmsbulkapi/common/messaging_api_secured_json.php',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'API-Secured-Key': 'YOUR_API_SECURED_KEY_HERE',  // Required! From API Keys & Secrets
        'Content-Length': Buffer.byteLength(data)
    }
};

const req = https.request(options, (res) => {
    let body = '';
    res.on('data', chunk => body += chunk);
    res.on('end', () => {
        console.log('Status:', res.statusCode);
        console.log('Response:', JSON.parse(body));
    });
});

req.write(data);
req.end();

# SMS webhook URL with Sender ID
https://www.bestsmsbulk.com/bestsmsbulkapi/shopify/shopifyAPI.php?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&route=sms&senderid=MYSTORE

# Example:
https://www.bestsmsbulk.com/bestsmsbulkapi/shopify/shopifyAPI.php?api_key=your_api_key&api_secret=your_api_secret&route=sms&senderid=SHOPIFY

# WhatsApp with approved template
https://www.bestsmsbulk.com/bestsmsbulkapi/shopify/shopifyAPI.php?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&route=wp&template=order_confirmation

# Note: Template variables are automatically extracted from the Shopify order data
# Available variables: customer_name, order_id, total_price, tracking_number