← 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
Velocity · 7d
+0.4
★ / day
Trend
steady
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.

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