furious-monkey v2.0.1

Furious-Monkey

A free sms api to send api messages to clients, without boundaries or costs. Now using node and python to send plain-text sms messages to a wide range of mobile providers.

Requirements

Python version 2.7.* is required for use

Installation

npm install furious-monkey

Testing

cd lib
username=username password=password to=reciever python furious_monkey_tests.py

Continuing to improve testing measures to ensure the reliability of Furious-Monkey Currently as the complexity of the module is very small, I do not see a need go with automated testing. With the multitude of mobile providers and email services, testing the possible combinations would be futile. So raise an issue you come across, and I will gladly look into it asap.

Examples

var fm = require('furious-monkey');
var opts = {
  subject: 'furious-monkey',
  region: 'us',
  phoneNumber: 1234561234,
  message: 'I'm a mad monkey'
};

fm.sendText(opts,function(info){
	console.log(info);
});

Run with following command

node username=your-email-username passowrd=your-email-password host=email-provider furious-monkey.js

i.e. node username=furious-monkey password=password1234 host=aol furious-monkey.js

Note: Not recommended but host/username/password fields can be provided in options variable otherwise will be gathered from enviroment variables

• Those using Hotmail/Live/iCloud must provide full email address as their username i.e. username=foobar@live.com

• Verify with your email provider for daily sending limits

Available Email Providers

• Gmail - google
• Yahoo - yahoo
• Live - live
• Outlook - outlook
• Hotmail - hotmail
• iCloud - icloud
• AOL - aol

Complete list can be found lib/smtp_services.js

Options

options = {
  subject : type {String},
  region : type {String},
  message : type {String} - required,
  phoneNumber: type {Number/String} - required,
  host: type {String} - required,
  username: type {String} - required,
  passowrd: type {String} - required
}

Available Regions

The default is set to US

• US
• EU
• AFR
• AS
• AUS
• SA
• MEX
• CAN

Currently supported carriers

United States of America

• Alltel
• AT & T
• Boost Mobile
• Cricket Wireless
• Project Fi/Google
• Republic Wireless
• Sprint
• T-Mobile
• U.S. Cellular
• Verizon
• Virgin Mobile

Europe

• Vodafone
• Orange
• Telecom
• T-Mobile
• Telcel

Asia

• Airtel
• China Mobile
• NTT DoCoMo
• Orange

Africa

• SafariCom
• Mtn
• Vodacom

Mexico

• Nextel
• Iusacell
• Telcel

Canada

• Bell
• Bell Mobility
• Koodo
• Fido
• Manitoba
• NBTel
• PageNet
• Rogers
• Sasktel
• Telus
• Virgin Mobile

South America

• Nextel
• Claro

Australia

• Optus Mobile
• Telstra

Complete list can be found lib/carriers.js

Limitations

Known

• T-Mobile - if the message isn't sent from the same server as the provided email provider, then message is marked as spam and never goes through
• Requires the use of a personally email provider in an effort to keep it lightweight with little dependencies

Contributions

If you would like to help make contributions or have questions/comments on usage please drop me an email via trejon_house@yahoo.com with the subject line 'Furious-Monkey'.