bluebubbles

Integrate BlueBubbles messaging with Moltbot via webhooks and REST.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/Yogi-076/Vajrascan.on --skill bluebubbles-yogi-076
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/Yogi-076/Vajrascan.on/tree/main/moltbot/skills/bluebubbles
Command: npx skills add https://github.com/Yogi-076/Vajrascan.on --skill bluebubbles-yogi-076

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers build or update the BlueBubbles channel plugin for Moltbot by consolidating guidance for webhook inbound handling, REST sends/probes, runtime bridging, and attachment/interaction processing so integrations route messages reliably into the core reply pipeline.

Core Features & Use Cases

  • Channel integration: Instructions for extension packaging, channel implementation, and registering the runtime bridge to onboard BlueBubbles as a Moltbot channel.
  • Webhook and REST plumbing: Best practices for registering HTTP handlers, normalizing variable payloads, implementing health probes, and using shared REST helpers with timeouts.
  • Attachment and interaction handling: Guidance for inbound media placeholders, downloading attachments, sending reactions/tapbacks, typing indicators, and gating actions via configuration.
  • Use case: Onboard a BlueBubbles instance by adding the extension, configuring channels.bluebubbles.serverUrl and channels.bluebubbles.webhookPath, enabling webhook registration, validating probe responses, and verifying message routing and attachments into Moltbot.

Quick Start

Use the bluebubbles skill to implement and test the BlueBubbles channel plugin with webhook handling, REST helpers, and runtime integration configured.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I integrate a BlueBubbles server with Moltbot using webhooks?

To integrate BlueBubbles with Moltbot, register HTTP webhook handlers, normalize inbound payloads, configure channels.bluebubbles.serverUrl and channels.bluebubbles.webhookPath, then validate health probes and message routing.

What is required to register a BlueBubbles channel plugin in Moltbot?

Registering a BlueBubbles channel plugin requires extension packaging, runtime bridge registration, and configuration keys including channels.bluebubbles.serverUrl and channels.bluebubbles.password to connect the messaging server to Moltbot.

How do I handle media attachments and typing indicators for a Moltbot channel?

Handling attachments and typing indicators involves downloading inbound media placeholders, sending reactions and tapbacks, and gating these interaction actions via configuration keys within the Moltbot channel plugin.

How do webhook health probes work for BlueBubbles REST integrations?

Webhook health probes for BlueBubbles REST integrations validate probe responses using shared REST helpers with timeouts, ensuring the runtime bridge maintains reliable message routing into the core reply pipeline.

Does Moltbot support BlueBubbles tapbacks and message reactions?

Moltbot supports BlueBubbles tapbacks and message reactions through the channel plugin by processing inbound interaction payloads and gating the outbound reaction sends via configuration keys.

Why is my BlueBubbles webhook payload not routing messages into Moltbot?

BlueBubbles webhook payloads may fail to route into Moltbot if inbound normalization is misconfigured, health probes fail, or channels.bluebubbles.serverUrl and webhookPath configuration keys are missing.