Why hacky? messenger-personal-api is an Electron app that extracts messages from Messenger.com's DOM... so not optimal, but working solution.

npm install messenger-personal-api --save

You will need to have electron package installed as well.

import { MessengerAPI } from 'messenger-personal-api'

const api = new MessengerAPI({
    email: '[email protected]',
    pass: 'SuperSecretPassword'
})

api.start()

api.on('new_message', message => {
    console.log(`${message.sender}: ${message.content}`)
})

electron .

You will need to run your program as an Electron app.

TIP: If you need the API for non-electron app, you can build a very simple http(s) server on Electron and let it send POST requests to your app.

If you initialize the API with both e-mail and password, user will be logged in automatically.

If you only fill in the e-mail, you'll be prompted to type in your password securely via HTTPS connection to Messenger.com.

Password encryption will hopefully be implemented in future versions of the API.

const api = new MessengerAPI({
    email: '[email protected]',
    // Hard-code your password only if
    // you don't distribute this piece of app
    // where it could get decompiled
    pass: 'SuperSecretPassword'
})

// Simply start the API
api.start()

// Or start and listen to useful messages
// (e.g. logged in, couldn't log in etc)
api.start((err, message) => {
    if (err) {
        console.error(err.content)
    } else {
        console.log(message)
    }
})

api.on('new_message', message => {
    // new message object
})

All messages are sent to you as objects, e.g.:

{
    type: 'text',
    date: 1496966580162, // Date in UTC format
    sender: 'Your Friend',
    sender_id: '1032752459',
    content: 'Chill out my friend 😎'
}

Returns plain text with emojis in content

Returns URL of the image/s in content

Returns URL of the video in content

Returns URL of the attached file in content

Returns 👍 in content

Returns URL of the sticker in content

Returns URL of the inflated emoji in content

Returns the GIF URL in content

Returns the link from featured tab in content

Currently can't retrieve the actual message.

These are some points that need few hours of work:

• ability to send messages
• leave DOM as much as possible (during final debugging, I found out messages are also passed to front-end in server response inside thread_info.php)
• genuinely secure way to store password in configuration

So if you're awesome and want to contribute to this project, go fork, clone and send pull requests!

Thanks to Caprine for DOM-wrapped-in-Electron app inspiration.

This is a third-party application and is not affiliated with Facebook.