NAME

    Nexmo::SMS - Module for the Nexmo SMS API!

VERSION

    version 0.10

SYNOPSIS

    This module simplifies sending SMS through the Nexmo API.

        use Nexmo::SMS;
    
        my $nexmo = Nexmo::SMS->new(
            server   => 'https://rest.nexmo.com/sms/json',
            username => 'testuser1',
            password => 'testpasswd2',
        );
        
        my $sms = $nexmo->sms(
            text     => 'This is a test',
            from     => 'Test02',
            to       => '452312432',
        ) or die $nexmo->errstr;
        
        my $response = $sms->send || die $sms->errstr;
        
        if ( $response->is_success ) {
            print "SMS was sent...\n";
        }

METHODS

 new

    create a new object

        my $foo = Nexmo::SMS->new(
            server   => 'https://rest.nexmo.com/sms/json',
            username => 'testuser1',
            password => 'testpasswd2',
        );

    Those parameters are optional and they are used as defaults for the
    message objects

 sms

    Create a new message object or returns undef.

        my $sms = $nexmo->sms(
            text     => 'This is a test',
            from     => 'Test02',
            to       => '452312432',
        ) or die $nexmo->errstr;

    Send a binary message

        my $binary = $nexmo->sms(
            type     => 'binary',
            udh      => '06050415811581',   # hex encoded udh
            body     => '0011223344556677', # hex encoded body
            from     => 'Test02',
            to       => '452312432',
        ) or die $nexmo->errstr;

 errstr

    return the "last" error as string.

        print $nexmo->errstr;

 get_balance

      my $balance = $nexmo->get_balance;

 get_pricing

    Not implemented yet...

Attributes

    These attributes are available for Nexmo::SMS::TextMessage objects. For
    each attribute there is a getter/setter:

      $nexmo->server( 'servername' );
      my $server = $nexmo->server;

      * password

      * server

      * username

ACKNOWLEDGEMENTS

    Jui-Nan Lin added support for Unicode messages, thanks! (see
    https://github.com/reneeb/perl-Nexmo-SMS/pull/1/files)

AUTHOR

    Renee Baecker <reneeb@cpan.org>

COPYRIGHT AND LICENSE

    This software is Copyright (c) 2016 by Renee Baecker.

    This is free software, licensed under:

      The Artistic License 2.0 (GPL Compatible)