← all repositories
fossasia/susi_fbbot

A chatbot bridge to Facebook's walled garden

This is the glue code that wires the AskSusi AI assistant into Facebook Messenger, complete with a 13-step setup guide that assumes you enjoy clicking through admin panels.

1.5k stars JavaScript Chat AssistantsAgents
susi_fbbot
Not currently ranked — collecting fresh signals.
star history

What it does

A Node/Express webhook that receives Facebook Messenger messages, forwards them to the Susi AI API, and pipes the responses back to the user. It is essentially a protocol adapter: Facebook’s Messenger Platform on one side, Susi’s conversational backend on the other.

The interesting bit

The README treats bureaucratic integration as a feature. Thirteen annotated screenshots walk you through creating a Facebook Page, generating access tokens, configuring Heroku environment variables, and subscribing webhooks — a visual survival guide for anyone who has cursed at Facebook’s developer dashboard.

Key highlights

  • Deploys to Heroku or Google Cloud Kubernetes with minimal code changes
  • Uses standard Messenger Platform webhooks and page access tokens
  • Development branch is default; CI runs on Travis and CircleCI
  • GPLv3 licensed, matching the broader FOSSASIA Susi ecosystem
  • 1,516 stars suggest this filled a genuine need for Susi users on Facebook

Caveats

  • The README does not describe what Susi actually does or how its API behaves; you are expected to know already
  • No mention of rate limits, error handling, or message formatting beyond the basic webhook plumbing
  • Setup guide references Facebook Graph API v2.6, which dates the documentation

Verdict

Worth a look if you need to bootstrap a Messenger bot quickly and prefer annotated screenshots to guessing at Facebook’s UI. Skip it if you want a framework — this is a single-purpose integration, not a reusable library.

Frequently asked

What is fossasia/susi_fbbot?
This is the glue code that wires the AskSusi AI assistant into Facebook Messenger, complete with a 13-step setup guide that assumes you enjoy clicking through admin panels.
Is susi_fbbot open source?
Yes — fossasia/susi_fbbot is open source, released under the LGPL-2.1 license.
What language is susi_fbbot written in?
fossasia/susi_fbbot is primarily written in JavaScript.
How popular is susi_fbbot?
fossasia/susi_fbbot has 1.5k stars on GitHub.
Where can I find susi_fbbot?
fossasia/susi_fbbot is on GitHub at https://github.com/fossasia/susi_fbbot.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.