automate-whatsapp — Claude Code skill: Kapso WhatsApp flows
A skill for building and debugging Kapso WhatsApp automations: workflows, triggers, functions and execution tracing.
npx skills add gokapso/agent-skills --skill automate-whatsapp -a claude-codeWhat automate-whatsapp does
The skill walks an agent through Kapso work: creating and editing workflows, changing the graph, wiring inbound message and Project Event triggers, emitting events, reading executions, managing functions, webhook tools and MCP tools. It fits projects where the WhatsApp automation already runs on Kapso and you would rather change it from the editor than click through a web UI.
The preferred route is a local repo under source control. You need the Kapso CLI installed and authenticated (kapso login), then kapso link to bind the project, kapso pull to fetch, kapso build and kapso push to ship. Workflow code uses @kapso/workflows, with a Workflow instance exported from workflow.js or workflow.ts. A fallback exists through the KAPSO_API_BASE_URL and KAPSO_API_KEY environment variables.
Graph edits through the API scripts are a fallback for debugging or API-only setups, not the default. Watch lock_version there: on a conflict you re-fetch, re-apply and retry with the new value. One trap worth knowing before you plan the work — a workflow started by a Project Event trigger is an observer and cannot emit Project Events, so adding emission to it will not work.
Debugging runs through kapso logs search with an execution ID, then listing executions, reading context values and events. Functions are created by script and deployed as a separate step, and the public endpoint flag is supported for Cloudflare functions only.
What it helps with
- assemble a WhatsApp workflow from nodes and edges in a local repo
- attach an inbound message trigger to the right phone number
- register a Project Event and react to it from a workflow
- trace a failed execution by its ID and find the broken step
- create a function and deploy it to Kapso
Example prompts for the agent
- Show me the graph for the inbound-support workflow and add a reply node
- Create an inbound_message trigger for this workflow using the project number
- Pull up this execution ID and tell me why it failed
How to install automate-whatsapp
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill automate-whatsapp -a claude-code2Manually: put the files in place
~/.claude/skills/automate-whatsapp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/automate-whatsapp/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill automate-whatsapp -a codex2Manually: put the files in place
.agents/skills/automate-whatsapp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill automate-whatsapp -a cursor2Manually: put the files in place
.cursor/skills/automate-whatsapp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gokapso/agent-skills automate-whatsapp2Manually: put the files in place
.github/skills/automate-whatsapp/SKILL.md1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill automate-whatsapp -a gemini-cli2Platform CLI
gemini skills install https://github.com/gokapso/agent-skills --path skills/automate-whatsappManually: put the files in place
.devin/skills/automate-whatsapp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill automate-whatsapp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about automate-whatsapp
How do I install automate-whatsapp in Claude?
Run npx skills add gokapso/agent-skills --skill automate-whatsapp -a claude-code. The skill lands in ~/.claude/skills/automate-whatsapp/SKILL.md.
What does automate-whatsapp do?
It guides an agent through building and debugging Kapso WhatsApp automations: workflows, triggers, Project Events, executions and functions.
What do I need before using the skill?
An installed and authenticated Kapso CLI, plus a source-controlled project with kapso link and kapso pull for workflow and function edits. Without the CLI you can fall back to KAPSO_API_BASE_URL and KAPSO_API_KEY.
