클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

WhatsApp Cloud 채널 추가

NanoClaw에 공식 Meta WhatsApp Business Cloud API 채널을 어댑터 복사부터 웹훅·자격증명 설정까지 단계별로 붙여주는 스킬.

웹·API 연동중급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

  • channels 브랜치에서 WhatsApp Cloud 어댑터 파일(src/channels/whatsapp-cloud.ts)을 가져와 프로젝트에 복사합니다.
  • 채널 배럴(src/channels/index.ts)에 자기등록 import 한 줄을 추가하고, @chat-adapter/whatsapp을 정확한 버전으로 고정 설치합니다.
  • pnpm run build와 등록 테스트(vitest)로 어댑터가 실제로 레지스트리에 등록됐는지 검증합니다.
  • Meta 개발자 콘솔에서 받아야 하는 값(Phone Number ID, 영구 액세스 토큰, App Secret, Verify Token)을 물어보고 .env에 안전하게 기록합니다(이미 값이 있으면 덮어쓰지 않음).
  • 웹훅 서버(기본 3000 포트, /webhook/whatsapp-cloud) 노출 방법과 흔한 실패 원인 해결법을 안내합니다.

이런 분께 추천

  • NanoClaw 기반 에이전트를 운영하며 WhatsApp으로 사용자와 1:1 대화를 연결하려는 분
  • 비공식 Baileys 방식이 아닌 Meta 공식 Cloud API로 안정적인 채널을 쓰고 싶은 분
  • 웹훅·토큰 설정에서 자주 막혀서 체크리스트형 가이드가 필요한 분

활용 예시

  • "WhatsApp Cloud 채널 붙여줘" → 어댑터 복사, import 등록, 의존성 설치, 빌드/테스트까지 순서대로 수행.
  • 이전 버전에서 whatsapp 키로 등록해 두었던 설치본 업그레이드 → 웹훅 경로를 /webhook/whatsapp-cloud로 바꾸고 Meta 대시보드 콜백 URL 갱신.
  • 하루 뒤 모든 호출이 401로 실패 → 임시 토큰 대신 System User 영구 토큰을 발급해 WHATSAPP_ACCESS_TOKEN 교체.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-whatsapp-cloud/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-whatsapp-cloud 폴더를 내 ~/.claude/skills/add-whatsapp-cloud/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 작업 폴더로 이동합니다.
  2. 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  3. 스킬 폴더를 Claude 스킬 디렉터리에 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/
  4. NanoClaw 프로젝트 루트에서 Claude Code를 실행합니다(이 스킬은 해당 저장소 구조를 전제로 합니다).
  5. "WhatsApp Cloud 채널을 추가해줘"라고 요청하면 스킬이 Apply 단계를 순서대로 실행합니다.
  6. Meta for Developers에서 Business 앱을 만들고 WhatsApp 제품을 추가한 뒤, Phone Number ID·영구 토큰·App Secret·Verify Token 네 값을 준비해 프롬프트에 입력합니다.
  7. ngrok(ngrok http 3000) 등으로 3000 포트를 공개하고, Meta 대시보드 웹훅 URL을 https://도메인/webhook/whatsapp-cloud로 설정한 뒤 서비스를 재시작합니다.
GitHub에서 원본 보기 ↗라이선스: MIT