integrate-whatsapp — скилл для Claude Code: суть и установка
Скилл подключает WhatsApp к продукту через Kapso, помогает выдавать ссылки на онбординг, ловить события через вебхуки и отправлять сообщения.
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-codeЧто делает 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-соединения и редиректы блокируются на уровне скриптов.
Какие задачи решает
- настроить онбординг клиентов через Kapso setup links
- развернуть вебхуки для отслеживания входящих сообщений WhatsApp
- отправить текстовые и шаблонные сообщения через Kapso CLI или SDK
- определить business_account_id и phone_number_id для подключённого номера
- управлять сценариями WhatsApp Flows и шифрованием конечных точек
Примеры запросов агенту
- Помоги подключить WhatsApp к проекту через Kapso CLI и создай ссылку для онбординга нового клиента.
- Проверь список подключённых телефонных номеров через команду kapso whatsapp numbers list.
- Настрой вебхук уровня телефонного номера для приёма входящих сообщений WhatsApp.
Как установить integrate-whatsapp
1Через Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-code2Вручную: положить файлы
~/.claude/skills/integrate-whatsapp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/integrate-whatsapp/
1Через Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a codex2Вручную: положить файлы
.agents/skills/integrate-whatsapp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a cursor2Вручную: положить файлы
.cursor/skills/integrate-whatsapp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gokapso/agent-skills integrate-whatsapp2Вручную: положить файлы
.github/skills/integrate-whatsapp/SKILL.md1Через Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a gemini-cli2Командой платформы
gemini skills install https://github.com/gokapso/agent-skills --path skills/integrate-whatsappВручную: положить файлы
.devin/skills/integrate-whatsapp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill integrate-whatsapp -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о integrate-whatsapp
Как установить integrate-whatsapp в Claude Code?
Выполните команду npx skills add gokapso/agent-skills --skill integrate-whatsapp -a claude-code в терминале.
Что делает скилл integrate-whatsapp?
Он позволяет настроить сквозное подключение WhatsApp через Kapso, генерировать ссылки на онбординг, получать вебхуки с событиями и отправлять сообщения адресатам.
Что требуется для безопасной работы с секретами?
Скрипты маскируют секреты в выводе терминала. Чтобы перехватить разовый токен, укажите путь к новому файлу в переменной KAPSO_SECRET_OUTPUT_FILE перед запуском запроса.
