Textnow.js NPM

TextNow API

textnow.js is a node.js module that uses TextNow to enable free programmable texting

Credit

Developer: Leonardo Wu-Gomez
Reddit: leogomezz4t
Please tell me if you have any ideas for the API or reporting a bug

Installation

Method One: Using git clone

git clone https://github.com/leogomezz4t/textnow.js.git

Method Two: Using npm

npm install textnow.js --save

Usage

Ways to authenticate

const tn = require("textnow.js")

// Way 1. Just instantiate and a prompt will appear on the command line
const client = new tn.Client("email")
// Way 3. If you inputed the wrong cookie and are getting failed requests. This is how to reset it
client.auth_reset()
// will redo the prompt

How to send an sms message

(async () => {
await client.sendSMS("number", "Hello World!")
})

How to get new messages

const newMessages = await client.getUnreadMessages() -> Array
for (const message of newMessages):
    await message.markAsRead()
    console.log(message)
    // Message object
    // content: "body of sms"
    // number: "number of sender"
    // date: datetime object of when the message was received
    // read: bool
    // id: int
    // direction: SENT_MESSAGE_TYPE or RECEIVED_MESSAGE_TYPE
    // first_contact: bool if its the first time that number texted you
    // type: MESSAGE_TYPE if type is Message and MULTIMEDIAMESSAGE_TYPE if type is MultiMediaMessage

    // Functions
    // async markAsRead() will post the server as read
    // async sendSMS() will send an sms to the number who sent the message
    
    // MultiMediaMessage object
    // All the attributes of Message
    // content: url of media
    // rawData: bytes of the media
    // contentType: str the MIME type ie. "image/jpeg" or "video/mp4"
    // extension: str of the file extension is. "jpeg" or "mp4"
    // Functions
    // mv(file_path): downloads the file to file_path

    console.log(message.number)
    console.log(message.content)

    // MultiMediaMessage

    console.log(message.content_type)
    message.mv("./image." + message.extension)

How to get all messages

const messages = await client.getMessages() -> Array
// Same as above

How to get all sent messages

const sentMessages = await client.getSentMessages() -> Array
// same as above

Simple bot snippet

const tn = require("textnow.js")

(async () => {
    const client = new tn.Client("email")
    client.on("message", msg => {
        if (msg.content === "ping") {
            await client.sendSMS(msg.number, "pong")
        }
    })
})()