From chatwoot-skills
Configure Chatwoot — manage teams, agents, inboxes, webhooks, automation rules, canned responses, custom attributes, and custom filters. Use when setting up, administering, or configuring a Chatwoot instance.
How this skill is triggered — by the user, by Claude, or both
Slash command
/chatwoot-skills:chatwoot-admin-configurationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Guide for setting up and managing Chatwoot infrastructure using mcp-chatwoot MCP tools.
Guide for setting up and managing Chatwoot infrastructure using mcp-chatwoot MCP tools.
Account
├── Agents (support staff)
├── Teams (groups of agents)
│ └── Team Members (agents in team)
├── Inboxes (communication channels)
│ ├── Inbox Members (agents handling this inbox)
│ └── Agent Bot (optional bot per inbox)
├── Automation Rules (event-driven actions)
├── Canned Responses (message templates)
├── Custom Attributes (data field definitions)
├── Custom Filters (saved query presets)
└── Webhooks (external notifications)
teams_create(
account_id: 1,
name: "Billing Support",
description: "Handles billing and payment inquiries"
)
→ { id: 3, name: "Billing Support" }
agents_list(account_id: 1)
→ Find agent IDs: [5, 7, 12]
team_members_add(
account_id: 1,
team_id: 3,
user_ids: [5, 7, 12]
)
team_members_delete(
account_id: 1,
team_id: 3,
user_ids: [12]
)
agents_create(
account_id: 1,
name: "Alice Johnson",
email: "[email protected]",
role: "agent"
)
Roles: "agent" (standard) or "administrator" (full access).
agents_list(account_id: 1)
→ [{ id: 5, name: "Alice", role: "agent" }, ...]
Inboxes represent communication channels (email, web chat, API, WhatsApp, etc.).
Inbox creation varies by channel type. The channel parameter determines the required fields.
API channel (most common for programmatic use):
inboxes_create(
account_id: 1,
name: "API Channel",
channel: {
type: "api",
webhook_url: "https://your-app.com/webhook"
}
)
inbox_members_create(
account_id: 1,
inbox_id: 5,
user_ids: [5, 7]
)
inboxes_set_agent_bot(
account_id: 1,
id: 5,
agent_bot_id: 2
)
Reusable message templates that agents can quickly insert.
canned_responses_create(
account_id: 1,
short_code: "greeting",
content: "Hello! Thanks for reaching out. How can I help you today?"
)
Agents type /greeting in the chat to insert this response.
canned_responses_list(account_id: 1, search: "greeting")
Define custom data fields for conversations or contacts.
custom_attributes_create(
account_id: 1,
attribute_display_name: "Plan Type",
attribute_display_type: "list",
attribute_description: "Customer's subscription plan",
attribute_key: "plan_type",
attribute_model: "conversation_attribute"
)
attribute_model: "conversation_attribute" or "contact_attribute"
attribute_display_type: "text", "number", "link", "date", "list", "checkbox"
custom_attributes_list(account_id: 1, attribute_model: "contact_attribute")
Saved search presets for conversations or contacts.
custom_filters_create(
account_id: 1,
name: "Urgent Unassigned",
filter_type: "conversation",
query: {
"payload": [
{ "attribute_key": "priority", "filter_operator": "equal_to", "values": ["urgent"], "query_operator": "AND" },
{ "attribute_key": "assignee_id", "filter_operator": "is_not_present", "values": [], "query_operator": null }
]
}
)
filter_type: "conversation" or "contact"
Receive HTTP notifications when events occur in Chatwoot.
webhooks_create(
account_id: 1,
url: "https://your-app.com/chatwoot-webhook",
subscriptions: [
"conversation_created",
"conversation_status_changed",
"message_created",
"message_updated"
]
)
| Event | Description |
|---|---|
conversation_created | New conversation |
conversation_status_changed | Status toggled |
conversation_updated | Conversation modified |
message_created | New message |
message_updated | Message edited |
contact_created | New contact |
contact_updated | Contact modified |
webwidget_triggered | Widget event |
See the chatwoot-automation-patterns skill for comprehensive automation rule configuration.
See SETUP_GUIDE.md for step-by-step setup walkthroughs.
See AUTOMATION_RULES.md for automation rule syntax reference.
npx claudepluginhub fazer-ai/chatwoot-skills --plugin chatwoot-skillsInteracts with Channel Talk workspaces via TypeScript CLI: send messages to user chats/groups, read chats, manage groups/bots using API credentials. For support automation and CI/CD.
Manages Intercom conversations: create from contacts, reply as admin/note/user, assign to admins/teams, close, snooze, tag via Node.js/TypeScript client. For support automation.
Automates Intercom operations via Composio/Rube MCP: conversations, contacts, companies, segments, and admins. Activates on Intercom-related queries.