Syngonium banner

Syngonium

1 devlog
2h 26m 23s

A tiny Slack bot that answers short Qs using your FAQ. It reads a local FAQ and posts concise, FAQ-backed replies in threads.

Demo Repository

Loading README...

Barnabás

Shipped this project!

Try asking a question in #construct-help channel

Barnabás

So basically it’s a Slack bot that answers FAQs. Pretty straightforward, right? You throw your FAQ docs at it and when someone asks a question in Slack, the bot uses an AI API to search through your FAQ and answers them with a concise, FAQ-backed reply in a thread.

The main things it does:
Reads your local FAQ file (markdown) and uses that as context
Hits an AI API with your question, validates the response follows specific rules (needs a greeting, must mention the FAQ source, suggests closing the ticket)
Has rate limiting and a circuit breaker so it doesn’t nuke your API quota or keep retrying forever
Supports concurrent workers so it can handle multiple questions at once
Has a manager dashboard where certain users can sync workspace members across channels
There’s also some channel management stuff — you can set it up to auto-invite people to specific channels and monitor others for new members. Ships with a health check endpoint and metrics tracking so you can see how many requests it’s handling.

The validation is pretty strict though — it checks that the bot doesn’t encourage follow-ups (no “let me know” or “any other questions” type stuff), which makes sense for keeping tickets moving.

0