VM0VM0
Agent Skills

Chatwoot

Customer support platform for multi-channel messaging

Chatwoot is an open-source customer support platform for managing conversations across multiple channels including website, email, and WhatsApp.

Required Environment

NameTypeDescription
CHATWOOT_API_TOKENsecretAPI access token from Chatwoot Profile Settings
CHATWOOT_ACCOUNT_IDvarAccount ID from the URL (e.g., /app/accounts/1/...)
CHATWOOT_BASE_URLvarBase URL (e.g., https://app.chatwoot.com)

Configuration

vm0.yaml
version: "1.0"

agents:
  my-agent:
    framework: claude-code
    skills:
      - https://github.com/vm0-ai/vm0-skills/tree/main/chatwoot

Run

Store your secret on the platform (recommended, one-time setup):

vm0 secret set CHATWOOT_API_TOKEN your-chatwoot-api-token

Then run your agent - secret is automatically loaded:

vm0 run my-agent "list open conversations"

For CI/CD or temporary overrides, pass secrets at runtime: --secrets CHATWOOT_API_TOKEN=value. See Environment Variables for details.

Example Instructions

AGENTS.md
# Support Agent

You use Chatwoot to manage customer support conversations.

## Workflow

1. List open conversations
2. Read conversation messages
3. Send appropriate replies
4. Update conversation status

## Guidelines

- Use private notes for internal communication
- Assign conversations to appropriate agents
AGENTS.md
# Contact Manager Agent

You use Chatwoot to manage customer contacts.

## Workflow

1. Search for existing contacts
2. Create new contacts if needed
3. Update contact information
4. Link contacts to conversations

## Contact Fields

- name, email, phone_number
- identifier (external system ID)
- custom_attributes