# integrate-whatsapp

Connects WhatsApp to your application through Kapso to onboard customers with setup links, receive webhook events, and dispatch messages.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4700 installs · ★ 190
- Author: gokapso
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gokapso/agent-skills/tree/HEAD/skills/integrate-whatsapp/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/integrate-whatsapp

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/integrate-whatsapp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/integrate-whatsapp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/integrate-whatsapp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/integrate-whatsapp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gokapso/agent-skills integrate-whatsapp
```

2. **Manually: put the files in place**
- File: `.github/skills/integrate-whatsapp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gokapso/agent-skills --path skills/integrate-whatsapp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/integrate-whatsapp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gokapso/agent-skills/tree/HEAD/skills/integrate-whatsapp/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [twilio-whatsapp-send-message](https://affpapa.org/en/nevibecode/skills/twilio-whatsapp-send-message.md) — skill · 2 installs
- [whatsapp](https://affpapa.org/en/nevibecode/skills/whatsapp.md) — skill · 368 installs
- [whatsapp-automation](https://affpapa.org/en/nevibecode/skills/whatsapp-automation.md) — skill · 6500 installs
- [whatsapp-marketing](https://affpapa.org/en/nevibecode/skills/whatsapp-marketing.md) — skill · 1600 installs
- [sent-two-way-messaging](https://affpapa.org/en/nevibecode/skills/sent-two-way-messaging.md) — skill · 2700 installs
- [twilio-conversations-classic-api](https://affpapa.org/en/nevibecode/skills/twilio-conversations-classic-api.md) — skill · ★ 7596

From the same set: [gokapso/agent-skills](https://affpapa.org/en/nevibecode/by/gokapso/agent-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md