gators

Free and easy texting framework for node using SMS gateways.

// see below for auth template
const auth = require('../auth.js')
const gator = require('gators')(auth)

gator.on('connected', () => console.log('connected!'))

gator.on('message', (info, sendReply) => {
  // info object contains message data
  const text = info.texts[0].value
  const images = info.texts[0].value

  // send reply
  if (text === 'ping') sendReply('pong')
})

gator.on('error', (err) => console.log(err))

gator.connect()

Getting Started

DISCLAIMER: This package has not been tested with all SMS gateway providers nor phone operating systems.

For a list of supported providers, see SUPPORT.md.

For instructions on how you can contribute, see CONTRIBUTE.md.

This is a module from npm.

Before installing, download and install node.js and npm.

Install gators

$ npm i -s gators

Create auth file from template

$ touch auth.js

auth.js

module.exports = {
  account: {
    user: '****@****.com',
    pass: '$!J$#LK#K'
  },
  smtp: {
    host: 'smtp.*****.com',
    port: 465,
    secure: true
  },
  imap: {
    host: 'imap.*****.com',
    port: 993,
    secure: true
  }
}

Manually test with one of the included examples

$ cp ./node_modules/gators/examples/ping.js ./examples

$ node ./examples/ping.js

Automated tests coming soon...

Built With

• node-imap - IMAP Client
• Nodemailer - SMTP Client
• Mailparser - Elegantly parse emails
• html-to-text - HTML interpreter

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Coding Style

Authors

• jdtzmn - Initial work - jdtzmn

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• This amazing README template.
• NodeICO for the npm badge.
• gitignore.io for .gitignore