NAME

SMS::Send::UK::BTSmartMessaging

VERSION

Version 0.0.2

SYNOPSIS

    # Instantiate a sender object
    my $sender = SMS::Send->new(
        'UK::BTSmartMessaging',
        _login    => 'username',
        _password => 'password',
    );

    # Send a message
    my $sent = $sender->send_sms(
        text => 'This is my message, must be <= 160 characters',
        to   => '0000000000' # In the format: 447312345679
    );

DESCRIPTION

SMS::Send::UK::BTSmartMessaging is a SMS::Send driver that provides SMS message sending via the BT Smart Messaging Tailored powered by Soprano HTTP API

CAVEATS

You need a BT Smart Messaging Tailored powered by Soprano account in order to use this driver

METHODS

new

    # Instantiate a sender object
    my $sender = SMS::Send->new(
        'UK::BTSmartMessaging',
        _login    => 'username',
        _password => 'password',
    );

The new constructor accepts three parameters, all of which are required:

The return value is a SMS::Send::UK::BTSmartMessaging object.

'UK::BTSmartMessaging'

The parameter identifying the driver name

_login

The _login parameter as supplied by BT

_password

The _password parameter as supplied by BT

clean_to

    # Examine a passed phone number and attempt to return the number
    # in an international format, croak of a conversion is not possible
    my $intl_number = clean_to($source_number);

The clean_to method accepts a single required parameter:

The return value is the number in international format

source_number

A string containing the number to be cleaned

send_sms

    # Send a message
    my $sent = $sender->send_sms(
        text => 'This is my message, must be <= 160 characters',
        to   => '0000000000' # In the format: 447312345679
    );

The send_sms method accepts two parameters, both of which are required:

The return value is a 0 or 1 representing false or true, indicating whether the send was successful.

text

A string of text representing the message, limited to 160 characters

to

A numeric string representing the phone number of the recipient, in a valid international format (i.e. country code followed by the number)

AUTHOR

Andrew Isherwood <andrew.isherwood at ptfs-europe.com>

BUGS

Please report any bugs or features to andrew.isherwood at ptfs-europe.com

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc SMS::Send::UK::BTSmartMessaging

COPYRIGHT & LICENSE

Copyright (C) 2018 PTFS Europe https://www.ptfs-europe.com/

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself

Additionally, you are again reminded that this software comes with no warranty of any kind, including but not limited to the implied warranty of merchantability.

ANY use my result in charges on your BT Smart Messaging bill, and you should use this software with care. The author takes no responsibility for any such charges accrued.

ACKNOWLEDGEMENTS

Many thanks to the authors of the following modules that served as inspiration for this one:

SMS::Send::US::TMobile

SMS::Send::US::Ipipi

SMS::Send::UK::Kapow

cpanm SMS::Send::UK::BTSmartMessaging

perl -MCPAN -e shell
install SMS::Send::UK::BTSmartMessaging