- WhooshBang developer docs
WhooshBang developer docs
Add reliable Telegram notifications and human decisions to an application or AI agent.
Notifications your software can trust
WhooshBang gives an application or AI agent one API for sending Telegram notifications, asking a person for a decision, and reading the result. Delivery is asynchronous, every accepted request is durable, and test credentials can never reach a real subscriber.
Start with the outcome you need
- Send your first notification goes from an empty organization to a message on a real phone in three commands, then walks the same journey through the API.
- Put your own bot in front of your users covers the three identities a subscriber can see, and what each one costs you.
- Ask for a decision adds confirm, select, or text-input interactions and shows how to wait for the answer.
- Connect an agent points an MCP client at WhooshBang and makes a first tool call.
- The command line reference documents every command and every argument.
- Upgrade an existing integration covers the organization contract change for SignalSitter and other invited-alpha clients.
- The integration reference is for putting sends behind retries, showing delivery state, and diagnosing a failure.
The production API is https://api.whooshbang.com. Everything above can be
done from a terminal; the dashboard is another way in,
not a required one.
Invited alpha
Public sign-up is closed and no invitation is automatic. There is no waitlist form and no self-service path: an invitation is an email, and following its link is what creates your account. Sign in with that same account afterwards — including when an agent sends you to WhooshBang to authorize it, where the sign-in screen will say so and offer no way to create an account.
Your WhooshBang organization contains your projects. Your invitation puts you in one, or you create your own the first time you sign in; either way you need one before you can create a project, and the dashboard says so if you arrive without one.
An invitation also enables real Telegram subscription links and live sends, one participant at a time. You can build and exercise the complete test journey before that. Tell your WhooshBang contact when your first real use case is ready to try.