abduselam/afromessage

PHP SDK for Afro message

v0.4.0 2025-03-17 15:10 UTC

Requires

• laravel/pint: ^1.21

Requires (Dev)

• illuminate/support: ^10.23

MIT

• abduselam1

README

This SDK provides a convinient access to the Afro message API.

Installation

composer require abduselam/afromessage

• Put your api key and sender id in your .env

AFRO_API_KEY=*********

AFRO_SENDER_ID=*********

• Publish config file

php artisan vendor:publish --tag=afromessage-config

Gettig started

Simple usage looks like this

use Afromessage\AfroMessage;

$response = AfroMessage::send("[phone]","Hello there");

Methods

This methods provides exactly the same functionality as the actual API of afromessage if you need detail on how it works browse Afromessage API

send

To send a text message to a phone number use this send method 2 Required argument.

1. Recipient phone number.
2. Message

• Optional parameters *

Paramater	Type	Description
from	string	The value of the system identifier id if you have subscribed to multiple short codes.
sender	string	The value of Sender Name to use for this message. only for verified users
template	int	Indicates the message is a template id rather than the actual message
callback	string	The callback URL(GET) you want to receive SMS send progress.
method	string	http method POST or GET (defuld is POST)

• Example

$response = AfroMessage::send("[phone]","Hello there",method: "GET");

Bulk

To send a text message to a phone number use this send method 2 Required argument.

1. Recipient phone numbers.
2. Message

• Optional parameters *

Paramater	Type	Description
from	string	The value of the system identifier id if you have subscribed to multiple short codes.
sender	string	The value of Sender Name to use for this message. only for verified users
campaign	int	The name of the campaign given for this bulk send. It will show in the list of campaigns and you can monitor the progress.
createCallback	string	our callback URL we will call whenever a message is queued for sending from the batch. This endpoint must be a POST endpoint that takes a JSON body.
statusCallback	string	Your usual status callback URL you use for the other endponts. It must be a GET endpoint and we will send message status as it changes states

• Example

$recipients = [
    "[phone]",
    '[phone]',
];
$message = "Hello There";
$from = "IDENTIFIER";
$sender = $sender;
$campaign = $campaign;
$createCallback = $createCallback;
$statusCallback = $statusCallback;

// If you want to send personalized messages to a list of phone numbers.. update the recipients

$recipients = [
    [
        'to' => '251987654321',
        'message' => 'Hello 1',
    ],
    [
        'to' => '251912345678',
        'message' => "Hello 2"
    ],
];

$response = AfroMessage::bulk($recipients, $message, $from, $sender, $campaign, $createCallback, $statusCallback);

code

This method helps you to send a short code Whether you want to send a one time password (OTP) or put in place a two-factor-authentication in your systems.

1 Required argument.

1. Recipient phone number.

• Optional parameters *

Paramater	Type	Description
codeLength	int	The character length of the security code. Default is 4
type	string	The type of code you want to send (numeric, alphanumeric, alphabet). Defult is numeric
timeToExpire	int	The number of seconds for this code to be expired (defualt 0 which is not expired.)
prefix	string	A message prefix that you can prepend to the code
postfix	string	A message postfix that you can append right after the code
spaceBefore	int	The number of empty spaces you want to add between generated code and message prefix.(default is 1)
spaceAfter	int	The number of empty spaces you want to add between generated code and message postfix.(default is 1)
from	string	The value of the system identifier id if you have subscribed to multiple short codes.
sender	string	The value of Sender Name to use for this message. only for verified users
callback	string	The callback URL(GET) you want to receive SMS send progress.

• Example

$response = AfroMessage::code("[phone]",codeLength: 5, type: 'alphanumeric', postfix: "Is your otp");

verify

Verification method to validate code to the corresponding phone number 1 Required argument.

1. code.

• Optional parameters *

Paramater	Type	Description
Recipient	string	phone number of the recipient. Either this or verificationCod
verificationCode	string	The verification Id you received when sending security codes

• Example

$response = AfroMessage::verify("23124",recipient: "[phone]");