skills.rest
rafael-fae
rafael-faeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hermes-whatsapp-native

Configure a native WhatsApp bridge for Hermes Agent with pairing and routing.

5|Updated Jun 3, 2026
Search Tags:#messaging#whatsapp#webhook#bridge#systemd#hermes#baileys
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill hermes-whatsapp-native
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-whatsapp-native
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/archive/skills/operacao/hermes-whatsapp-native
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill hermes-whatsapp-native

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the guesswork from setting up and operating a native WhatsApp bridge for Hermes, so teams can communicate with agents directly without relying on a third-party WhatsApp API.

Core Features & Use Cases

  • Native WhatsApp Bridge Setup: Configure the Baileys-based Node.js bridge, QR pairing flow, systemd service, and HTTP endpoints needed for Hermes WhatsApp connectivity.
  • Operational Modes and Filtering: Switch between self-chat testing and production bot mode with allowlists, group policies, and message routing rules.
  • Troubleshooting and Integration: Diagnose session-path, JID/LID mapping, gateway placement, webhook forwarding, and bridge health issues in production-like deployments.

Quick Start

Ask the assistant to configure Hermes WhatsApp native mode for your host, including bridge setup, allowed users, session path, and troubleshooting guidance.

Frequently Asked Questions about hermes-whatsapp-native

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

FAQPage Schema
How do I configure a native WhatsApp bridge for Hermes without a third-party API?▼

To configure a native WhatsApp bridge for Hermes, set up the Baileys-based Node.js bridge, complete the QR pairing flow, and deploy the service via systemd with HTTP endpoints for message routing. This removes the need for third-party APIs.

Can I use self-chat mode for testing before deploying a WhatsApp bot to production?▼

Yes, you can switch between self-chat mode for testing and production bot mode. The bridge supports operational modes with allowlists, group policies, and message routing rules to control communication in different scenarios.

How does webhook forwarding work for multi-consumer message delivery in WhatsApp bridges?▼

Webhook forwarding enables multi-consumer message delivery by routing incoming WhatsApp messages to external HTTP endpoints. The bridge supports optional webhook integration alongside its native HTTP endpoints to distribute messages to multiple consumers.

Why is my WhatsApp bridge session dropping or failing to map JID and LID correctly?▼

Session drops and JID/LID mapping failures typically stem from incorrect session path configurations or gateway placement issues. Troubleshoot by verifying session persistence settings, checking JID/LID mapping rules, and diagnosing bridge health in your deployment.

Do I need Node.js and systemd to run a Hermes WhatsApp native bridge?▼

Yes, running a Hermes WhatsApp native bridge requires Node.js for the Baileys-based bridge support and systemd for service deployment. These components manage session persistence, HTTP endpoints, and operational modes like allowlists and group handling.

What is the best way to handle group messaging policies in a native WhatsApp bot?▼

The best way to handle group messaging policies is configuring group rules and allowlists within the bridge's operational modes. This ensures the bot filters and routes messages correctly based on production or testing scenarios.

Related Skills

Explore More Software Engineering Skills→
lpjhelderlpjhelder

forge-setup

Install and configure kronon-forge with Node.js and npm.

Community
Intermediate
amanmprojectsamanmprojects

grammy

Configure grammy Telegram bots for gateway integration with long polling or webhooks.

Community
Intermediate
aws-samplesaws-samples
21

governance

Register agents, configure Cedar policies, and set routing patterns.

Official
Advanced
whichguywhichguy

hermes-whatsapp-gateway

Configure and troubleshoot the Hermes WhatsApp Gateway using the Baileys bridge.

Community
Advanced