David Warring
and 1 contributors

NAME

SMS::Send::SMSGlobal::HTTP - SMS::Send SMSGlobal.com Driver

VERSION

VERSION 0.12

DESCRIPTION

SMS::Send::SMSGlobal::HTTP is a simple driver for SMS::Send for sending messages via www.smsglobal.com using the SMS Global HTTP API.

SUBROUTINES/METHODS

new

    use SMS::Send;

    my $sender = SMS::Send->new('SMSGlobal::HTTP',
               _user       => 'my-username',
               _password   => 'my-password',
               __transport => 'https',
               __verbose   =>  1
           );

send_sms

    my $sent = $sender->send_sms(
        to        => '+61 4 8799 9999',
        text      => 'Go to the window!',
        _from     => 'Clang',
        _scheduledtime => DateTime
                             ->now(time_zone => 'Australia/Melbourne')
                             ->add(minutes => 5)
    );

Basic Options

to

The recipient number. This can either be an international number (prefixed with +) or an local number (with a leading 0).

Note: In the case of a local number, the country will be determined by your Default SMS Country Locale Setting in your account preferences.

text

The text of the message.

_from

Sets the from caller-ID. This can either be a reply telephone number, or an alphanumeric identifier matching ^[0-9a-zA-Z_]+$. For details. see http://www.routomessaging.com/dynamic-sender-id-service.pmx .

_maxsplit (default 3)

The maximum number of 150 character (approx) transmission chunks. You may need to increase this to send longer messages.

Note: Each chunk is metered as a separate message.

_scheduledtime

Lets you delay sending of messages. This can be either (a) a string formatted as yyyy-mm-dd hh:mm:ss or (b) an object that supports ymd and hms methods. For example DateTime or Time::Piece objects.

Note: Your date times need to to be specified in the same timezone as set in your SMSGlobal account preferences.

HTTP-2WAY Options

Some extra options for handling SMS replies. These are useful when you are using dedicated incoming numbers, with your account. See http://www.smsglobal.com/docs/HTTP-2WAY.pdf:

_api

Set to 0, to disabled two-way messaging. The default is 1 (enabled).

_userfield

Custom field to store internal IDs or other information (Maximum of 255 characters)

Configuration Options

__address

SMSGlobal gateway address (default: 'http://www.smsglobal.com/http-api.php');

__transport

Transport to use: 'http' (default) or 'https'.

Transport over 'https' is encrypted and more secure. However, this option requires either Crypt::SSLeay or IO::Socket::SSL to be installed. More information is available at http://search.cpan.org/dist/libwww-perl/README.SSL.

__verbose

Set to true to enable tracing.

Sending SMS to Multiple Recipients

It is possible to specify multiple recipients in a request. However, this requires direct use of the SMS::Send::SMSGlobal::HTTP driver:

    use SMS::Send::SMSGlobal::HTTP;

    my $driver = SMS::Send::SMSGlobal::HTTP->new(
        _user => $sms_login,
        _password => $sms_pass,
        __verbose => 1,
        __transport => 'https',
    );

The driver can accept either an array of mobile numbers or a string containing a comma-separated list of mobile numbers.

   my @recipients = ( '+61(4)770090099', '0419 123 456' );

   my $sent = $driver->send_sms( _from => $caller_id,
                                 to    => \@recipients,
                                 text  => 'Hi everyone!',
                                );

The return value is the number of messages queued for delivery to individual recipients.

__responses contains sucesss or error codes for each recipient.

    if ( $sent < scalar @recipients ) {
        warn "failed to send to some participants";

        my @responses = @{ $driver->__responses || [] };
        for ( @responses ) {
            warn $_ if m{ERROR};
        }
    }

AUTHOR

David Warring, <david.warring at gmail.com>

BUGS AND LIMITATIONS

This module only attempts to implement the simple HTTP/S sendsms command as described in http://www.smsglobal.com/docs/HTTP.pdf and http://www.smsglobal.com/docs/HTTP-2WAY.pdf.

There are other API's available (http://www.smsglobal.com/en-au/technology/developers.php). Among the more fully featured are the SOAP interface (http://www.smsglobal.com/docs/SOAP.pdf) and SMPP (http://www.smsglobal.com/docs/SMPP.pdf).

Please report any bugs or feature requests to bug-sms-send-au-smsglobal at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SMS-Send-SMSGlobal-HTTP. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc SMS::Send::SMSGlobal::HTTP

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2011-2012 David Warring.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.