andreasanta/nexmo-php-lib

There is no license information available for the latest version (dev-master) of this package.

dev-master 2016-06-23 17:38 UTC

This package is not auto-updated.

Last update: 2024-09-11 14:53:36 UTC


README

Sending SMS via the Nexmo SMS gateway.

Quick Examples

  1. Sending an SMS
$sms = new NexmoMessage('account_key', 'account_secret');
$sms->sendText( '+447234567890', 'MyApp', 'Hello world!' );
  1. Recieving SMS
$sms = new NexmoMessage('account_key', 'account_secret');
if ($sms->inboundText()) {
    $sms->reply('You said: ' . $sms->text);
}
  1. Recieving a message receipt
$receipt = new NexmoReceipt();
if ($receipt->exists()) {
    switch ($receipt->status) {
        case $receipt::STATUS_DELIVERED:
             // The message was delivered to the handset!
             break;
         
         case $receipt::STATUS_FAILED:
         case $receipt::STATUS_EXPIRED:
             // The message failed to be delivered
             break;
    }
}
  1. List purchased numbers on your account
$account = new NexmoAccount('account_key', 'account_secret');
$numbers = $account->numbersList();

Most Frequent Issues

Sending a message returns false.

This is usually due to your webserver unable to send a request to Nexmo. Make sure the following are met:

  1. Either CURL is enabled for your PHP installation or the PHP option allow_url_fopen is set to 1 (default).

  2. You have no firewalls blocking access to rest.nexmo.com/sms/json on port 443.