Africans Talking Sms for PhPNuxBill

# HOW TO INSTALL & USE AFRICA'S TALKING BULK SMS SCRIPT (africastalking.php)

## Introduction

This simple PHP script lets you send bulk SMS messages using the Africa's Talking API by simply accessing a URL. It's perfect for standalone use or integrating into any system (e.g., PHPNUXBILL, WHMCS, etc.) via HTTP GET.

---

## Requirements

- PHP 7.0 or higher  
- cURL enabled  
- Africa's Talking account with:
 - Username  
 - API Key  
 - Approved Sender ID  

---

## Installation

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

---

## Usage

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

https://yourdomain.com/africastalking.php?message=Hello%20World&phone=+254711XXXXXX&api_key=YourAPIKey&sender_id=YourSenderID&username=YourUsername

---

## Parameters (via GET)

| Parameter   | Description                               | Required |
|-------------|-------------------------------------------|----------|
| message     | The SMS content                           | Yes      |
| phone       | Phone number(s), comma-separated for bulk | Yes      |
| api_key     | Africa's Talking API key                  | Yes      |
| sender_id   | Your approved sender ID                   | Yes      |
| username    | Your Africa's Talking username            | Yes      |

Note: Phone numbers must be in international format (e.g., 254711XXXXXX)

---

## Example

https://yourdomain.com/africastalking.php?message=Hello+there!&phone=254711111111,254722222222&api_key=YOUR_API_KEY&sender_id=MyBiz&username=myusername

---

## Notes

- Works with single or multiple phone numbers.
- Script does not require login or database—ideal for quick use or remote integration.
- Avoid exposing this endpoint publicly without authentication in production environments.
- You can easily embed it into systems that support HTTP GET calls (e.g., Laravel, WordPress, PHPNUXBILL, etc.)

---

## Security Tip

To prevent unauthorized use, consider:
- Restricting access with IP whitelisting.
- Adding a secret token in the request (e.g., ?token=XYZ123).
- Using .htaccess to block unwanted access.

---

## Support

For issues with:
- The script itself → contact your developer/integrator.
- SMS delivery or Africa’s Talking API → https://africastalking.com/contact

---

Made for developers who move fast 🚀  
Send SMS in seconds, no bloat.