Buko Developer Docs
Welcome to the Buko developer documentation.
Private Developer Preview: Bot integrations and public Bot API access are
not included in the current iOS App Store release. Kit development and
third-party Kit submission are also not publicly open. These references are
retained for internal testing, approved preview partners, and future reviewed
releases; production Bot endpoints currently return unavailable.
Buko is a private messenger. Developer APIs are intentionally narrow: Buko provides the messaging channel, identity, delivery, permissions, and quotas. Your agent or service provides the actual intelligence and business logic.
Available APIs
- Bot API single-page guide documents the Developer Preview protocol for future reviewed releases. Public access is not currently open.
- Kit Development guide defines the source, capability, server, platform, security, and testing contract for reviewed native Kit modules. Kit development remains a private Preview and is not open for public enrollment or self-service submission. Official Kits that appear in the app are compiled into and reviewed with that app release.
Production URLs
| Service | URL |
|---|---|
| Developer docs | https://buko.app/dev-docs/ |
| Bot API base | https://ims.buko.app |
| Bot Gateway WebSocket | wss://ims.buko.app/bot/ws |
| Web app | https://web.buko.app |
Bot API preview
The following shape is documentation only while the Bot release gate is closed.
export BUKO_BOT_TOKEN="bot_xxx"
curl -sS https://ims.buko.app/bot/getMe \
-X POST \
-H "Authorization: Bot $BUKO_BOT_TOKEN" \
-H "Content-Type: application/json"
Then use either Bot Gateway WebSocket for realtime updates or polling for simple deployments.
Kit development in one minute
A native Kit is a reviewed local Dart package under kits/. It implements the small KitModule contract, declares the platforms it has actually tested, and uses only host-provided capabilities through KitContext. The server catalog can narrow visibility or disable a Kit, but it cannot download code or enable a platform omitted by the compiled package.
Read the complete Kit Development guide before creating a module.