bluebubbles

Integrates BlueBubbles plugin with Moltbot via REST, webhooks, and runtime bridging.

1|Updated Jan 28, 2026

Search Tags:#integration #rest #plugin #extension #webhook #bluebubbles #channel-development

Ready to run

npx skills add https://github.com/Zentin-L/Masterbot --skill bluebubbles-zentin-l

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/Zentin-L/Masterbot/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/Zentin-L/Masterbot --skill bluebubbles-zentin-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables Moltbot to connect with BlueBubbles, delivering cross-platform messaging via a dedicated extension.

Core Features & Use Cases

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

Quick Start

Implement or update the BlueBubbles extension by working with the extensions/bluebubbles directory and its core source files.

Frequently Asked Questions about bluebubbles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I build a BlueBubbles channel plugin for cross-platform messaging?▼

To build a BlueBubbles channel plugin, you develop within the extensions/bluebubbles directory, implementing core files like index.ts, channel.ts, and monitor.ts to enable seamless messaging bridging.

How does webhook inbound handling work for the BlueBubbles extension?▼

Webhook inbound handling is implemented in monitor.ts and registered via api.registerHttpHandler, allowing the BlueBubbles extension to process incoming messages and bridge them to the runtime.

Can I use REST APIs to send and probe messages in a BlueBubbles channel?▼

Yes, the BlueBubbles extension provides REST helpers in send.ts and probe.ts, allowing you to send outbound messages and probe connection status directly through the channel implementation.

Do I need an existing codebase to integrate the BlueBubbles plugin?▼

Yes, integrating the BlueBubbles plugin requires a codebase present in extensions/bluebubbles with key entry points such as index.ts, channel.ts, monitor.ts, and supporting utilities for REST operations.

What's the best way to update the BlueBubbles extension runtime bridge?▼

To update the BlueBubbles extension runtime bridge, you modify runtime.ts and set it via api.runtime, ensuring that the channel implementation correctly bridges messaging interactions between Moltbot and BlueBubbles.

Why does the BlueBubbles channel require a catalog entry for onboarding?▼

The BlueBubbles channel requires a catalog entry in src/channels/plugins/catalog.ts to properly register the extension during onboarding, enabling the system to recognize and initialize the cross-platform messaging plugin.