integrate-whatsapp — Claude Code skill: what it does, how to install
Connects WhatsApp to your application through Kapso to onboard customers with setup links, receive webhook events, and dispatch messages.
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-codeWhat integrate-whatsapp does
This skill guides an end-to-end WhatsApp integration using Kapso infrastructure. It helps you onboard clients through hosted setup links, resolve phone number identifiers via the CLI, and confirm project permissions. When calling endpoints directly, requests authenticate using the X-API-Key header.
Event handling is split between project webhooks for connection lifecycles and phone-number webhooks for incoming messages or delivery statuses. Scripts mask sensitive credentials in conversational output automatically. To save sensitive tokens securely, you must specify KAPSO_SECRET_OUTPUT_FILE before running setup operations.
You can operate through the Kapso CLI or use the @kapso/whatsapp-cloud-api package. The integration blocks unencrypted HTTP calls and unexpected redirects by default, so local testing requires an explicit development flag.
What it helps with
- generate hosted Kapso setup links for customer onboarding
- configure phone-number and project-level webhooks for WhatsApp events
- resolve phone_number_id and business_account_id via CLI
- send text and template messages using Kapso CLI or the SDK
- manage WhatsApp Flows endpoints and payload encryption
Example prompts for the agent
- Help me start WhatsApp onboarding for a new customer using Kapso CLI setup links.
- List all connected WhatsApp phone numbers and resolve their IDs.
- Create a phone-number webhook to handle incoming WhatsApp messages.
How to install integrate-whatsapp
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-code2Manually: put the files in place
~/.claude/skills/integrate-whatsapp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/integrate-whatsapp/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a codex2Manually: put the files in place
.agents/skills/integrate-whatsapp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a cursor2Manually: put the files in place
.cursor/skills/integrate-whatsapp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gokapso/agent-skills integrate-whatsapp2Manually: put the files in place
.github/skills/integrate-whatsapp/SKILL.md1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a gemini-cli2Platform CLI
gemini skills install https://github.com/gokapso/agent-skills --path skills/integrate-whatsappManually: put the files in place
.devin/skills/integrate-whatsapp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-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 integrate-whatsapp
How to install integrate-whatsapp in Claude Code?
Run the command npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-code in your terminal.
What does the integrate-whatsapp skill do?
It connects WhatsApp to your application through Kapso, managing customer onboarding links, webhook registrations, and outbound messaging.
How does the skill handle sensitive API credentials?
Scripts mask secret keys in printed output. To capture a generated token, point the KAPSO_SECRET_OUTPUT_FILE environment variable to a private file path before running the command.
