campaigningbureau/whatsatool-client

Laravel Package to communicate with the whatsatool API

Whats A Tool - Client

Description

This library gives you the basic functionality to communicate with the Whats A Tool API., _(*1)

Whats a Tool MSISDN on Wikipedia, _(*2)

Installation

First require in Composer:, _(*3)

composer require campaigningbureau/whatsatool-client, _(*4)

Add the Service Provider in your config/app.php:, _(*5)

'providers' => [
    ...
    CampaigningBureau\WhatsAToolClient\WhatsAToolClientProvider::class,
]

You can also add the Facade there:, _(*6)

'aliases' => [
    ...
    'WhatsAToolClient' =>  CampaigningBureau\WhatsAToolClient\WhatsAToolClientFacade::class,
]

Publish the config settings:, _(*7)

$ php artisan vendor:publish

Configuration

After publishing the config file you can edit them in config/whatsatool.php., _(*8)

Make sure you configure at least username and password., _(*9)

The default_country_code is used to create the correct MSISDN when a phonenumber with local country code is given (e.g. 0664/1234567), _(*10)

Usage

Validation

To validate a given number:, _(*11)

$phonenumber = '+43 664 123 456 87';
CampaigningBureau\WhatsAToolClient\Msisdn::validatePhonenumber($phonenumber);

The Validation cleans the phonenumber, that means removes all non-numeric characters and leading 00 and checks if: 1. The cleaned phonenumber is not empty 2. The length is shorter or equal to 15 characters (funny fact: there is no official minimum lengt restriction) 3. The phonenumber starts with a valid Country Code, which is either 0 for local or a country code that can be found in this list., _(*12)

Register Contact

To register a new Contact:, _(*13)

$phonenumber = '+43 664 123 456 87';
$msisdn = new Msisdn($phonenumber);
try {
    $simMsisdn = WhatsATool::registerContact($msisdn, $channel, $sendSms);
} catch (WhatsAToolException $exception) {
    Log::error($exception->getMessage());
}

This returns the msisdn of the Sim the number is registered to or throws a WhatsAToolException with the error message of the WhatsATool-API., _(*14)

Development

If you have PHPUnit installed in your environment, run:, _(*15)

$ phpunit

If you don't have PHPUnit installed, you can run the following:, _(*16)

$ composer update
$ ./vendor/bin/phpunit

Credits

The Msisdn-Logic is based on https://github.com/CoreProc/msisdn-ph-php/., _(*17)