NAME SMS::Send::UK::AA - Send SMS messages using Andrews and Arnold's gateway VERSION version 0.005 SYNOPSIS use SMS::Send; my $sender = SMS::Send->new("UK::AA", _login => '0123xxxxxx', _password => 'secret'); my $sent = $sender->send_sms( text => 'y u no txt bak', to => '+44 7xxx xxxxx' ); if($sent) { say "Message successfully sent"; } DESCRIPTION This is a SMS::Send compatible module that sends using the UK based provider Andrews and Arnold Ltd <http://aa.net.uk> (A&A). You will need a VoIP account with A&A in order to use this module. METHODS send_sms Sends an SMS. The return value will evaluate in boolean context to a false value, but will stringify to a useful message. It also has a "status_line" method which will return a one line status. PARAMETERS Certain private parameters not part of SMS::Send's API are implemented by this module. They all begin with an underscore ("_"). See the A&A docs for full details if not explained here. Constructor parameters * _login If using a VoIP line, must be provided, your A&A VoIP username (usually your phone number). Not required for direct to SIM delivery. * _password Must be provided, either the password associated with the above, or the SMS password configured along with your SIM. * _endpoint Set to the URI of an endpoint implementing this interface if a different endpoint to the default is needed. This module defaults to "https://sms.aa.net.uk/sms.cgi", if for some reason SSL doesn't work for you, you might want to set it to the non-SSL version. * _ssl_verify Set to a false value to disable SSL verification. This will automatically be disabled if you supply a HTTP URI above. "send_sms" parameters These parameters may be provided to either the constructor or the "send_sms" method. * _limit Limit number of parts. * _costcentre Reported on XML bill. * _private Do not show the text on the bill. * _oa Set a specific sender. * _originator Set a specific sender (same as oa, for backwards compatiblity). * _udh User data header, in hex. SEE ALSO * An example of an email to SMS gateway is in eg/sms.pl in the distribution. * SMS::Send * The HTTP interface this module implements is documented here: <http://aa.net.uk/kb-telecoms-sms.html>. AUTHOR David Leadbeater <dgl@dgl.cx> COPYRIGHT AND LICENSE This software is copyright (c) 2011 by David Leadbeater. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.