NAME

Net::SMS::Mtnsms - a module to send SMS messages using the Mtnsms web2sms gateway (http://www.mtnsms.com/).

SYNOPSIS

    my $sms = Net::SMS::Mtnsms->new(
        autotruncate => 1,
        username => 'yourname',
        password => 'yourpassword',
        recipient => 07713123456,
        signature => 'a test',
        message => 'a test message',
    );

    $sms->verbose( 1 );
    $sms->message( 'a different message' );
    print "sending message to mobile number ", $sms->recipient();

    $sms->send_sms();

DESCRIPTION

A perl module to send SMS messages, using the Mtnsms web2sms gateway. This module will only work with mobile phone numbers that have been registered with Mtnsms (http://www.mtnsms/) and uses form submission to a URL that may be subject to change.

There is a maximum length for SMS signature + message (160 for Mtnsms). If the sum of signature and message lengths exceed this, the behaviour of the Net::SMS::Mtnsms objects depends on the value of the 'autotruncate' argument to the constructor. If this is a true value, then the signature / message will be truncated to 123 characters. If false, the object will throw an exception (croak).

CONSTRUCTOR

The constructor for Net::SMS::Mtnsms takes the following arguments as hash values (see "SYNOPSIS"):

autotruncate (OPTIONAL)

Mtnsms has a upper limit on the length of the subject + message (123). If autotruncate is true, subject and message are truncated to 123 if the sum of their lengths exceeds 160. The heuristic for this is simply to treat subject and message as a string and truncate it (i.e. if length(subject) >= 123 then message is truncated to 0. Thanks to Mark Zealey <mark@itsolve.co.uk> for this suggestion. The default for this is false.

username (REQUIRED)

The Mtnsms username for the user (assuming that the user is already registered at http://www.mtnsms.com/.

password (REQUIRED)

The Mtnsms password for the user (assuming that the user is already registered at http://www.mtnsms.com/.

recipient (REQUIRED)

Mobile number for the intended SMS recipient.

subject (REQUIRED)

SMS message subject.

message (REQUIRED)

SMS message body.

verbose (OPTIONAL)

If true, various soothing messages are sent to STDERR. Defaults to false.

AUTOLOAD

All of the constructor arguments can be got / set using accessor methods. E.g.:

        $old_message = $self->message;
        $self->message( $new_message );

METHODS

send_sms

This method is invoked to actually send the SMS message that corresponds to the constructor arguments.

ACKNOWLEGEMENTS

Many thanks to P-A-N-D-O-R [pandor@compclub.sk] for access to a script he wrote for submitting SMS messages via mtnsms.

AUTHOR

Ave Wrigley <Ave.Wrigley@itn.co.uk>

COPYRIGHT

Copyright (c) 2001 Ave Wrigley. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Net::SMS::Mtnsms

perl -MCPAN -e shell
install Net::SMS::Mtnsms