Bluebubbles

Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).

Join 0+ developers using this skill

skill

Integrations

advanced

0 installs

View Source

Last updated: April 23, 2026

AI Skill Market Insights

Real data. Real impact.

Popularity

Rising

Emerging

Active Users

Developers

Quick Start

Manual Installation

No automatic installation available. Please visit the source repository for installation instructions.

View Installation Instructions

TEAR & SHARE

3-5hrs/WK

RISING

0.0K+ USING

BlueBubbles plugin

Use this skill when working on the BlueBubbles channel plugin.

Layout

Extension package:
```
extensions/bluebubbles/
```
(entry:
```
index.ts
```
).
Channel implementation:
```
extensions/bluebubbles/src/channel.ts
```
.

Webhook handling:

extensions/bluebubbles/src/monitor.ts

(register via

api.registerHttpHandler

REST helpers:

extensions/bluebubbles/src/send.ts

extensions/bluebubbles/src/probe.ts

Runtime bridge:

extensions/bluebubbles/src/runtime.ts

(set via

api.runtime

Catalog entry for onboarding:
```
src/channels/plugins/catalog.ts
```
.

Internal helpers (use these, not raw API calls)

probeBlueBubbles

extensions/bluebubbles/src/probe.ts

for health checks.

sendMessageBlueBubbles

extensions/bluebubbles/src/send.ts

for text delivery.

resolveChatGuidForTarget

extensions/bluebubbles/src/send.ts

for chat lookup.

sendBlueBubblesReaction

extensions/bluebubbles/src/reactions.ts

for tapbacks.

sendBlueBubblesTyping

markBlueBubblesChatRead

extensions/bluebubbles/src/chat.ts

downloadBlueBubblesAttachment

extensions/bluebubbles/src/attachments.ts

for inbound media.

buildBlueBubblesApiUrl

blueBubblesFetchWithTimeout

extensions/bluebubbles/src/types.ts

for shared REST plumbing.

Webhooks

BlueBubbles posts JSON to the gateway HTTP server.
Normalize sender/chat IDs defensively (payloads vary by version).
Skip messages marked as from self.
Route into core reply pipeline via the plugin runtime (
```
api.runtime
```
) and
```
clawdbot/plugin-sdk
```
helpers.
For attachments/stickers, use
```
<media:...>
```
placeholders when text is empty and attach media paths via
```
MediaUrl(s)
```
in the inbound context.

Config (core)

channels.bluebubbles.serverUrl

(base URL),

channels.bluebubbles.password

channels.bluebubbles.webhookPath

Action gating:
```
channels.bluebubbles.actions.reactions
```
(default true).

Message tool notes

Reactions: The
```
react
```
action requires a
```
target
```
(phone number or chat identifier) in addition to
```
messageId
```
. Example:
```
action=react target=+15551234567 messageId=ABC123 emoji=❤️
```

Bluebubbles

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

typesafe-mcp

Be Part of the 0+ Developer Community

BlueBubbles plugin

Layout

Internal helpers (use these, not raw API calls)

Webhooks

Config (core)

Message tool notes

Upgrade Stripe

README

MCP Apps Builder

jev-mcp (jkudish)

Channels

Learn

Compare

Company

Agents