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) - <http://www.tmcsms.com/>

    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
    <http://www.tmcsms.com/developers/>

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
    <http://rt.cpan.org/Public/Dist/Display.html?Name=SMS-Send-TMC>.

AVAILABILITY
    The project homepage is <https://metacpan.org/release/SMS-Send-TMC>.

    The latest version of this module is available from the Comprehensive
    Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a
    CPAN site near you, or see
    <https://metacpan.org/module/SMS::Send::TMC/>.

AUTHOR
    Nigel Metheringham <nigelm@cpan.org>

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.

