skills.rest
tapway
tapwayOFFICIAL
Explore all skills by this author →
WebsiteGitHub

chatwoot-bridge

Connects Chatwoot webhooks to a CRM agent for automated customer message handling.

1|Updated Jun 21, 2026
Search Tags:#crm#customer support#webhook#chatwoot#messaging automation#shared inbox#sla monitoring
One-click install
npx skills add https://github.com/tapway/shogun-os --skill chatwoot-bridge-tapway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chatwoot-bridge
Source: https://github.com/tapway/shogun-os/tree/main/skills/crm/chatwoot-bridge
Command: npx skills add https://github.com/tapway/shogun-os --skill chatwoot-bridge-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Customer messages arriving across WhatsApp, Instagram, Facebook, website chat, and email in Chatwoot require manual triage, drafting, and logging. This Skill bridges Chatwoot to the Kizuna CRM agent so inbound messages are classified, answered or drafted, escalated when needed, and logged to a knowledge base automatically. ## Core Features & Use Cases - Inbound Webhook Handling: Verifies HMAC-SHA256 signed Chatwoot webhooks, extracts message context, and classifies intent as inquiry, complaint, lead, support, or other. - Three Assignment Modes: Hermes-first auto-replies, human-first passthrough, or co-pilot mode that posts AI-drafted replies as private agent-only notes. - Contact Sync & Conversation Logging: Python scripts sync Chatwoot contacts to brain people pages and append conversation timeline entries. - SLA Monitoring: A scheduled script reports response times, quick-reply rates, and conversations breaching the 30-minute threshold. - Use Case: A customer asks for a quote via WhatsApp; the bridge classifies the intent, matches a brain template, and sends a reply requesting quantity, timeline, and requirements through the Chatwoot API. ## Quick Start Configure the Chatwoot API URL and access token in the Kizuna profile, then ask the agent to handle incoming Chatwoot customer messages and draft replies for review.

Frequently Asked Questions about chatwoot-bridge

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

FAQPage Schema
How do I connect Chatwoot to an AI agent for auto-replies?▼

Configure the Chatwoot API URL, account ID, and personal access token in the agent profile, then point a Chatwoot webhook at the agent. Incoming message_created events are verified via HMAC-SHA256 signature, classified by intent, and answered through the Chatwoot conversations messages API.

How to send private agent-only notes via the Chatwoot API?▼

POST to /api/v1/conversations/{id}/messages with message_type set to outgoing and the private field set to true. The note is visible only to human agents, which is how the co-pilot mode delivers AI-suggested replies without customers seeing them.

Chatwoot vs respond.io for customer messaging automation?▼

Chatwoot is a self-hosted open-source engagement platform suited to teams wanting full data control, while respond.io is a hosted alternative. This bridge targets Chatwoot deployments; respond.io users should use the dedicated respondio-bridge skill instead.

Why is my Chatwoot webhook returning 401 errors?▼

A 401 response indicates a webhook secret mismatch between the agent configuration and the Chatwoot dashboard. Verify that chatwoot.webhook_secret in the profile config matches the secret shown in Chatwoot, since signatures are computed with HMAC-SHA256 over the request body.

Can Chatwoot SLA response times be monitored automatically?▼

Yes, the included check-sla.py script fetches conversations via the Chatwoot API and reports quick-reply rates, average human response time, and conversations breaching 30 minutes. It can run as a cron job and post results to a Slack channel.

When should I not use Chatwoot for customer communication?▼

Avoid it for internal team chat, where Slack or Telegram is more appropriate, and for email-only workflows without a Chatwoot deployment, where a direct Gmail integration fits better. It is designed for shared-inbox customer messaging across social and web channels.

Related Skills

Explore More Marketing & Sales Skills→
MuhamadTAHMuhamadTAH

social-bots

Automate social media DMs and public comments via Chatwoot webhook bridge.

Community
Intermediate
aura-farmingaura-farming
3

reply-handling

Classify sales reply messages and route follow-up actions in CRM systems.

Community
Advanced
huiferhuifer
1

review-manager

Manage customer review collection, replies, and workflows for Shopify stores.

Community
Advanced
readdlereaddle
136

spark-recipe-shared-inbox-status

Count open, unassigned, completed, and per-member assigned work items in shared inboxes.

Official
Intermediate