클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

WhatsApp Cloud 채널 추가

NanoClaw에 Meta 공식 WhatsApp Business Cloud API 채널을 붙여주는 설치·검증 가이드 스킬입니다.

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

무엇을 해주나

NanoClaw 봇이 WhatsApp으로 메시지를 주고받을 수 있도록, Meta 공식 WhatsApp Business Cloud API 어댑터를 프로젝트에 설치하고 등록해 줍니다.

  • channels 브랜치에서 whatsapp-cloud.ts 어댑터와 등록 테스트 파일을 복사
  • 채널 배럴(src/channels/index.ts)에 자동 등록용 import 한 줄 추가
  • @chat-adapter/whatsapp@4.29.0 정확 버전 고정 설치(공급망 정책상 범위·latest 금지)
  • pnpm run build와 등록 테스트로 실제로 채널이 레지스트리에 붙었는지 검증
  • Meta 개발자 콘솔에서 받아야 하는 값(Phone Number ID, System User 영구 토큰, App Secret, Verify Token)을 대화형으로 물어보고 .env에 기록(이미 값이 있으면 덮어쓰지 않음)
  • 포트 3000 공용 웹훅 서버와 /webhook/whatsapp-cloud 경로, ngrok·Cloudflare Tunnel 노출 방법 안내

모든 단계가 멱등(idempotent)이라 중간에 실패해도 다시 실행할 수 있고, 예전 버전에서 whatsapp 키로 등록했던 설치본을 whatsapp-cloud로 옮기는 업그레이드 주의사항까지 정리되어 있습니다.

이런 분께 추천

  • NanoClaw로 WhatsApp 고객 응대·개인 비서 봇을 만들려는 개발자
  • Baileys(비공식) 대신 Meta 공식 API로 안정적인 채널을 쓰고 싶은 분
  • 이미 옛 버전 WhatsApp 어댑터를 설치했고 웹훅 경로 변경 때문에 메시지가 안 오는 분
  • 웹훅·터널링·토큰 만료 같은 실전 이슈 체크리스트가 필요한 분

활용 예시

  1. 신규 설치: "WhatsApp Cloud 채널 추가해줘" → 어댑터 복사·등록·빌드·테스트까지 진행하고, Meta 대시보드에서 얻은 4개 값을 입력받아 .env에 저장.
  2. 웹훅 검증 실패 해결: Meta의 "Verify and save"가 실패할 때, 서비스가 실행 중인지·WHATSAPP_VERIFY_TOKEN이 일치하는지·3000 포트가 외부에서 접근 가능한지 순서대로 점검.
  3. 하루 뒤 401 오류: API Setup의 임시 토큰(24시간 만료)을 쓰고 있었던 경우, System User 영구 토큰을 새로 발급해 WHATSAPP_ACCESS_TOKEN을 교체.

· · · 설치 가이드 · · ·

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 && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/

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

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/
  4. (권장) 이 스킬은 NanoClaw 프로젝트 안에서 동작하므로, 실제 작업은 cd nanoclaw 후 의존성 설치(pnpm install)까지 마친 상태에서 진행하세요.
  5. Claude Code를 프로젝트 루트에서 실행하고 "WhatsApp Cloud 채널을 추가해줘"라고 요청합니다.
  6. Meta for Developers에서 앱(Business 타입)을 만들고 WhatsApp 제품을 추가한 뒤, Phone Number ID / 영구 액세스 토큰 / App Secret / Verify Token 네 값을 준비해 프롬프트에 붙여넣습니다.
  7. 로컬 개발이라면 ngrok http 3000 등으로 3000 포트를 외부에 노출하고, 그 URL + /webhook/whatsapp-cloud를 Meta 대시보드의 웹훅 URL로 등록합니다.
  8. 마지막으로 pnpm run build와 등록 테스트가 통과하는지 확인하고, /manage-channels로 채널을 에이전트 그룹에 연결합니다.
GitHub에서 원본 보기 ↗라이선스: MIT