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:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-TextMessage-Canada

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Net-TextMessage-Canada

• CPAN Ratings

  http://cpanratings.perl.org/d/Net-TextMessage-Canada

• Search CPAN

  http://search.cpan.org/dist/Net-TextMessage-Canada/

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.