Skip to content

SDKs

Overview

Official SDKs for Python and JavaScript/TypeScript. Zero dependencies, typed models, webhook verification built in.

Also see: CI/CD Integrations · Webhook Verification


Python SDK

Install

pip install botbell

Send a notification

from botbell import BotBell

bot = BotBell("bt_your_token")
bot.send("Deploy succeeded ✅")

Wait for user approval

from botbell import BotBell, Action

bot = BotBell("bt_your_token")
reply = bot.send_and_wait(
    "Deploy to production?",
    actions=[
        Action(key="approve", label="Approve"),
        Action(key="reject", label="Reject"),
    ],
)
if reply and reply.action == "approve":
    deploy()

JavaScript / TypeScript SDK

Install

npm install @botbell/sdk

Send a notification

import { BotBell } from "@botbell/sdk";

const bot = new BotBell({ token: "bt_your_token" });
await bot.send("Deploy succeeded ✅");

Wait for user approval

const reply = await bot.sendAndWait("Deploy to production?", {
  actions: [
    { key: "approve", label: "Approve" },
    { key: "reject", label: "Reject" },
  ],
});
if (reply?.action === "approve") {
  deploy();
}

All Repositories

PackageInstallSource
botbellpip install botbellGitHub
@botbell/sdknpm install @botbell/sdkGitHub