/ 
SMS-Send-SMSGlobal-HTTP-0.02
River stage zero No dependents
/ SMS::Send::SMSGlobal::HTTP

NAME

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

VERSION

VERSION 0.02

DESCRIPTION

SMS::Send::SMSGlobal::HTTP is a simple driver for SMS::Send for sending messages via www.smsglobal.com using the HTTP/HTTPS CGI gateway.

SUBROUTINES/METHODS

new

use SMS::Send;

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

send_sms

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

HTTP Options

to

The recipient number, formatted as +<CountryCode><LocalNumber>

text

The text of the message. Note that that longer messages will be split sent in chunks of 160 characters. You may also need to increase _maxsplit to send longer messages.

_from

Sender's mobile number. Where to send replies.

_maxsplit (default 3)

The maximum number of 160 character transmisson 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) a date/time object that support ymd and hms methods. For example DateTime or Time::Piece objects.

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

HTTP-2WAY Options

Some extra options, as described in http://www.smsglobal.com/docs/HTTP-2WAY.pdf:

_api

enables 2-way message (default: 1 enabled)

_userfield

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

Internal Options

__verbose

enable tracing

__transport

transport to use; 'https' (default) or 'http'.

__method

http method to use 'post' (default) or 'get'

__address

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

AUTHOR

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

BUGS AND LIMITATIONS

This module only attempts to implement the frugal HTTP/S commands as described in http://www.smsglobal.com/docs/HTTP-2WAY.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 is the SOAP interface (http://www.smsglobal.com/docs/SOAP.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 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.