/ 
Net-TextMessage-Canada-0.02
River stage zero No dependents
/ Net::TextMessage::Canada

NAME

Net::TextMessage::Canada - determine the email address for a mobile phone

SYNOPSIS

This module will determine the email address for a canadian mobile phone from the phone number and mobile provider.

use Net::TextMessage::Canada;

my $ntmc = Net::TextMessage::Canada->new;

# Get the list of providers and their nice names
my $providers = $ntmc->providers;
for (@$providers) { ... }

# Convert a mobile phone provider + phone number into an email
my $email = $ntmc->to_email( $provider, $mobile_number );

DESCRIPTION

This module provides an easy interface to map a mobile phone to an email address to send them a text message.

If this list becomes out of date, please send me updated details.

IMPORTANT NOTE

The functionality of the email-to-SMS gateway is carrier dependent. That is to say: some carriers that appreciate you as a human being make it work seamlessly. Other carriers that want to maximize their wallets may make receiving these messages expensive and awkward. YMMV, IANAL, see store for details.

METHODS

$ntmc->providers();

This method returns an arrayref containing a hashref for each mobile provider in Canada. The hashref has two keys: id and name that contain a short id and the full name of the mobile provider.

$ntmc->to_email( $provider, $number );

This method returns the email address for the given number and mobile provider.

AUTHOR

Luke Closs, <cpan at 5thplane.com>

BUGS

Please report any bugs or feature requests to bug-net-textmessage-canada at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-TextMessage-Canada. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

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

perldoc Net::TextMessage::Canada

You can also look for information at:

ACKNOWLEDGEMENTS

Thanks to Canada's wonderful mobile phone companies for providing this service.

COPYRIGHT & LICENSE

Code is copyright 2009 Luke Closs, all rights reserved. All company names and email domains are obviously owned by those companies.

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