Artsy Chat Bot for Facebook Messenger
JavaScript HTML
Latest commit 5cfad59 Dec 12, 2016 @orta orta Fix typo for shows nearby
Failed to load latest commit information.


A Facebook Messenger bot for Artsy.

Allows you to explore Artworks, Artists and Articles in a pretty deep way by just clicking around.

Currently it's being hosted on my personal heroku, and with my own personal facebook app "Ortsy-art". Will be migrated into a real staging environment at some point.

App Structure

This is an Express app (see mitosis.js), that relies on Flow to interact with the Facebook API. It interacts with Facebook via a single "/webhook" response, and a single post API to Facebook.

If this style of JavaScript is new to you, consult the Danger JS guide.

The app splits into a few sections: bot, db and facebook. The bot is comprised of some core classes, then contexts. Each context is a section of the artsy browsing experience ( e.g. artist, artwork, gene etc.)

Want to test it?

You need to have Orta add your Facebook account to the testers page (link). Then go to the heroku page and click "Message Us".

The easiest way to start is to say "trending artists", then start interacting via the buttons that are provided.

If you want to see all off the potential elements we can use, say any of: "gif", "audio", "video", "image", "file", "button", "generic", "receipt", "quick reply", "read receipt", "typing on", "typing off", "account linking".

Read More

What is the focus?

  • Providing another way to subscribe to Artsy Articles
  • Offer a way to dive into some of our data

Setting up for Dev

Clone the repo, run yarn install

git clone
cd mitosis
yarn install

This is still a bit rough around the edges for contributors. As you cannot easily use the Facebook API to send you webhook notifications to you. However, to run a copy of the server, create a copy of config.default.json.example and make it config.default.


  • Allow you to connect to your Artsy account
  • Offer a way to get occasional notifications to trigger exploration
  • Think about what chat-like interfaces feel like in practice
  • Xapp tokens will need a way to consider themselves out of date, and get new ones

This is based on the Facebook Sample app, then I added flow, and started making it a real project.