Talksasa PHPNuxBill Gateway

# HOW TO INSTALL & USE TALK SASA BULK SMS SCRIPT (send_talksasa_sms.php)

## Introduction

This simple PHP script lets you send SMS messages using the TalkSasa API by accessing a URL.  
It’s ideal for use with standalone systems or integration into any platform (like PHPNUXBILL, WHMCS, etc.) via HTTP GET.

---

## Requirements

- PHP 7.0 or higher  
- cURL enabled  
- TalkSasa account with:
 - Approved Sender ID  
 - API Key  

---

## Installation

1. Upload `send_talksasa_sms.php` to any public directory on your web server.  
  Example URL:  
  https://yourdomain.com/send_talksasa_sms.php

---

## Usage

You can send an SMS by accessing the URL like this:

https://yourdomain.com/send_talksasa_sms.php?message=Hello%20World&phone=0712345678&api_key=YourApiKey&sender_id=YourSenderID

---

## Parameters (via GET)

| Parameter   | Description                             | Required |
|-------------|-----------------------------------------|----------|
| message     | The SMS content                         | Yes      |
| phone       | The phone number to send SMS to         | Yes      |
| api_key     | Your TalkSasa API key                   | Yes      |
| sender_id   | Your approved sender ID                 | Yes      |

Note: The phone number will be automatically formatted to the correct format (adds 254 if missing).

---

## Example

https://yourdomain.com/send_talksasa_sms.php?message=Your+code+is+123456&phone=0712345678&api_key=YOUR_API_KEY&sender_id=MyBrand

---

## Notes

- Only one phone number is supported per request in this script.
- No database is required—perfect for quick integrations and testing.
- The script returns the raw JSON response from the TalkSasa API.
- Can be triggered by external apps, webhooks, or backend systems.

---

## Security Tip

To avoid misuse, consider:
- Adding a secret token (e.g., ?token=abc123).
- Blocking public access using `.htaccess` or firewall.
- Limiting access to specific IP addresses.

---

## Support

For issues with:
- The script → contact your developer/integrator.
- SMS delivery or TalkSasa API → https://talksasa.com/contact/

---

Built for developers who want to send SMS fast. No noise, just results 🚀