NAME
SMS::Send::TMC - SMS::Send driver to send messages via TMC
(http://www.tmcsms.com/)
VERSION
version 0.01
SYNOPSIS
use SMS::Send;
# Create a sender
my $sender = SMS::Send->new(
'AQL',
_login => 'tmc_username',
_password => 'tmc_password',
);
# Send a message
my $sent = $sender->send_sms(
text => 'This is a test message',
to => '+61 (4) 1234 5678',
);
if ($sent) {
print "Message sent ok\n";
}
else {
print "Failed to send message\n";
}
DESCRIPTION
A driver for SMS::Send to send SMS text messages via TMC (Text Messaging
Centre) -
This is not intended to be used directly, but instead called by
SMS::Send (see synopsis above for a basic illustration, and see
SMS::Send's documentation for further information).
The driver uses the TMC HTTP GET API mechanism. This is documented at
METHODS
new
Constructor, takes argument pairs passed by SMS::Send, returns an
SMS::Send::TMC object. See usage synopsis for example, and see SMS::Send
documentation for further info on using SMS::Send drivers.
Additional arguments that may be passed include:-
_endpoint
The HTTP API endpoint. Defaults to
"https://www.tmcsms.co.uk/api/SendService.aspx"
_timeout
The timeout in seconds for HTTP operations. Defaults to 20 seconds.
_debug
Whether debugging information is output.
_reference
The reference used on sent messages - this will show up in the web
interface. For details of this see the "reference" parameter in the
API documentation. Defaults to "Message".
_source
The source identifier or number attached to the message. This has a
number of possible values - "Mobile", "CompanyName", "NickName",
"Signature" or "InboundNumber". For details of this see the "source"
parameter in the API documentation. The default is "InboundNumber"
_confirm
What form of confirmation should be sent. Binary or of the values 2
(for Mobile confirmation) and 4 (for Email confirmation). For
details of this see the "confirm" parameter in the API
documentation. Defaults to 0.
_unicode
Whether the message is in Unicode (a "true" value) or ASCII (a
"false" value). For details of this see the "unicode" parameter in
the API documentation. Defaults to "true".
send_sms
Send the message - see SMS::Send for details. Additionally the following
options can be given - these have the same meaning as they do in the
"new" method:-
* _reference
* _source
* _confirm
* _unicode
INSTALLATION
See perlmodinstall for information and options on installing Perl
modules.
BUGS AND LIMITATIONS
You can make new bug reports, and view existing ones, through the web
interface at
.
AVAILABILITY
The project homepage is .
The latest version of this module is available from the Comprehensive
Perl Archive Network (CPAN). Visit to find a
CPAN site near you, or see
.
AUTHOR
Nigel Metheringham
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Nigel Metheringham.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.