# integrate-whatsapp

Скилл подключает WhatsApp к продукту через Kapso, помогает выдавать ссылки на онбординг, ловить события через вебхуки и отправлять сообщения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4700 установок · ★ 190
- Автор: gokapso
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gokapso/agent-skills/tree/HEAD/skills/integrate-whatsapp/SKILL.md
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/skills/integrate-whatsapp

## Что делает

Скилл координирует сквозную интеграцию WhatsApp через сервис Kapso. С ним агент запускает онбординг клиентов через ссылки setup links, находит подключённые номера телефонов через CLI и проверяет статус доступа к проектам. Для прямой работы с API используется заголовок с ключом доступа `X-API-Key`.

Внутри заложена маршрутизация вебхуков двух уровней: на уровне проекта для жизненного цикла подключений и на уровне конкретного номера для сообщений и статусов доставки. Скрипты автоматически скрывают конфиденциальные токены в выводе терминала. Для сохранения одноразовых секретов нужно заранее задать переменную `KAPSO_SECRET_OUTPUT_FILE`, иначе прочесть их повторно не выйдет.

Перед отправкой сообщений агент выясняет идентификаторы через команду `kapso whatsapp numbers resolve`. Интеграция умеет работать как через Kapso CLI, так и через библиотеку `@kapso/whatsapp-cloud-api`, при этом небезопасные HTTP-соединения и редиректы блокируются на уровне скриптов.

## Установка

### Claude Code (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/integrate-whatsapp/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/integrate-whatsapp/

### Codex

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

2. **Вручную: положить файлы**
- Файл: `.agents/skills/integrate-whatsapp/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/integrate-whatsapp/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/gokapso/agent-skills --path skills/integrate-whatsapp
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/integrate-whatsapp/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

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

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gokapso/agent-skills/tree/HEAD/skills/integrate-whatsapp/SKILL.md

## Когда брать
- настроить онбординг клиентов через Kapso setup links
- развернуть вебхуки для отслеживания входящих сообщений WhatsApp
- отправить текстовые и шаблонные сообщения через Kapso CLI или SDK
- определить business_account_id и phone_number_id для подключённого номера
- управлять сценариями WhatsApp Flows и шифрованием конечных точек

## Примеры запросов агенту
- Помоги подключить WhatsApp к проекту через Kapso CLI и создай ссылку для онбординга нового клиента.
- Проверь список подключённых телефонных номеров через команду kapso whatsapp numbers list.
- Настрой вебхук уровня телефонного номера для приёма входящих сообщений WhatsApp.

## Похожие
- [twilio-whatsapp-send-message](https://affpapa.org/nevibecode/skills/twilio-whatsapp-send-message.md) — скилл · 2 установки
- [whatsapp](https://affpapa.org/nevibecode/skills/whatsapp.md) — скилл · 368 установок
- [whatsapp-automation](https://affpapa.org/nevibecode/skills/whatsapp-automation.md) — скилл · 6500 установок
- [whatsapp-marketing](https://affpapa.org/nevibecode/skills/whatsapp-marketing.md) — скилл · 1600 установок
- [sent-two-way-messaging](https://affpapa.org/nevibecode/skills/sent-two-way-messaging.md) — скилл · 2700 установок
- [twilio-conversations-classic-api](https://affpapa.org/nevibecode/skills/twilio-conversations-classic-api.md) — скилл · ★ 7596

Из того же набора: [gokapso/agent-skills](https://affpapa.org/nevibecode/by/gokapso/agent-skills.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md