← all repositories
fossasia/susi_viberbot

A chatbot bridge to nowhere in particular

This repo wires the SUSI AI assistant into Viber, mostly by asking you to click through a lot of screenshots.

1.5k stars JavaScript Chat AssistantsAgents
susi_viberbot
Velocity · 7d
+0.4
★ / day
Trend
steady
star history

What it does

It’s a webhook-based Viber bot that forwards messages to the SUSI AI API and returns the responses. The README is essentially a visual tutorial: fork, create a Viber public account, copy your key into a Heroku config var, edit a hardcoded URL on line 33 of index.js, deploy, and chat.

The interesting bit

The project treats documentation as a screenshot gallery — every step has an annotated phone-screen image, which is either admirably thorough or a sign that the setup is too fiddly to explain in text alone. The actual bot logic is thin enough that the README never discusses it; the value is entirely in the glue.

Key highlights

  • Forwards Viber messages to SUSI AI and relays responses back
  • Deploys on Heroku with GitHub auto-deploy from the development branch
  • Requires manual URL editing in source before first deploy (line 33 of index.js)
  • Viber public account requires manual approval via a support form
  • No code-level documentation; architecture is left as an exercise for the reader

Caveats

  • The README is pure setup walkthrough — no API details, no testing instructions, no mention of error handling
  • Hardcoded webhook URL and branch-based deployment suggest this is a tutorial scaffold, not a maintained service

Verdict

Grab this if you need a quick, visual reference for wiring Viber’s public account API to an external AI service. Skip it if you’re looking for a reusable bot framework or any insight into how SUSI AI actually works.

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