Developer integrations
Who this is for: third-party developers building bots or sticker packs for Buzzio users.
What is public
| Surface | Audience | Live home |
|---|---|---|
| Bot API (Telegram-shaped HTTP) | Bot developers | Bot API · all 150 methods · Console developers.buzzio.dev |
| Worker bots (OHG / Community) | Room tools | Worker bots |
| Sticker import | Sticker pack publishers | Sticker import API · sticker-api.buzzio.dev |
| This docs site | Everyone | doc.buzzio.dev |
| Open-source crypto / client refs | Researchers | Linked from How to verify |
What is not public
Buzzio does not publish a general messaging REST/GraphQL API or third-party client SDK to send or receive sealed user chats as if you were the mobile app.
You cannot:
- Read sealed 1:1, Whisper private chat, Whisper Questions, or E2E group ciphertext
- Upload sticker or bot media for Buzzio to host (you keep the files / URLs)
- Act as a person account via the Bot API
- Put a 12-word seed on the developer website
Clarified policy: No public messaging API.
Create a service bot (end-to-end)
Phone: @forge_bot → /newbot → Service → copy bzbot_… once
→ Desktop: developers.buzzio.dev → paste token
→ set webhook OR leave getUpdates running
→ Test /start → sendMessage welcome
→ Submit → auto approve / reject
→ Users search @your_bot → Start
Details: Bot API · user product: Bots.
Create a worker bot
Same Forge birth, but choose Worker. Link token → room admin Requests install → you Accept on Console. Details: Worker bots.
Publish stickers
Host art yourself (app ContentProvider / iOS pasteboard / HTTPS contents.json). User taps Add to Buzzio. Details: Sticker import API.
Who hosts what
| Buzzio hosts | You host |
|---|---|
| Forge (official control bot) | Every other bot’s code / brain |
| Bot records, hashed token, webhook URL | Your files, DB, media CDN |
| Short-lived bot DM text (~7 days) | Any longer archive you choose to keep |
| Delivery, rate limits, review, plans | Sticker pack files on your origin |
| Sticker import bridge docs site | Pack bytes (never uploaded to Buzzio) |
Legal
| Document | Where |
|---|---|
| Bot Terms | developers.buzzio.dev/legal/bot-terms |
| Bot Privacy | developers.buzzio.dev/legal/bot-privacy |
| Product Privacy / Terms | Legal and policies |
In-repo drafts: docs/legal/BOT_TERMS.md, docs/legal/BOT_PRIVACY.md. Sticker contract: docs/stickers/IMPORT_API.md.