bluebubbles

Integrate BlueBubbles channel with Xcriminal for message delivery and webhook handling.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill bluebubbles-xcriminal1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/xcriminal1/Xcriminal-bot/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill bluebubbles-xcriminal1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The BlueBubbles plugin enables Xcriminal to interface with the BlueBubbles channel, allowing secure, real-time message delivery via REST and inbound webhooks.

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

Configure the gateway to load and start the BlueBubbles plugin, enabling the BlueBubbles channel in the Xcriminal dashboard.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I integrate the BlueBubbles channel with Xcriminal for message delivery?

To integrate the BlueBubbles channel, configure the gateway to load the plugin, which enables REST message delivery, inbound webhook handling, and runtime bridging for real-time communication within the Xcriminal dashboard.

How does webhook handling work for inbound BlueBubbles messages?

Webhook handling processes inbound BlueBubbles messages by registering HTTP handlers via the API monitor module, allowing the system to receive and route real-time incoming chat data securely through the specified endpoint.

Can I use REST APIs to send messages and check BlueBubbles channel health?

Yes, you can use REST helpers to send outbound messages and probe endpoints to perform health checks, chat lookups, and media attachments handling without needing additional external libraries.

Do I need specific configuration to enable BlueBubbles media attachments and chat lookups?

Yes, specific internal helpers and configuration are required to perform health checks, chat lookups, and media attachments handling when setting up the BlueBubbles channel extension package.

What is the best way to set up the BlueBubbles plugin onboarding catalog?

The best way to set up the BlueBubbles plugin is through the catalog entry for onboarding, configuring the gateway to load and start the extension package to enable channel operation.

Why does the BlueBubbles runtime bridge require an API runtime set operation?

The runtime bridge requires an API runtime set operation to establish the necessary runtime environment, enabling secure message delivery and webhook bridging between the BlueBubbles channel and Xcriminal.