Claude Skill MartKhám phá skillSkill là gì?
 
← Về danh sách

Thêm kênh WhatsApp Cloud

Cài đặt và xác thực adapter WhatsApp Business Cloud API (chính thức của Meta) cho bot NanoClaw.

Web · APITrung cấp★ 30,471⑂ 12,865Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026

Làm được gì

Skill này gắn kênh WhatsApp Business Cloud API chính thức của Meta vào project NanoClaw:

  • Copy adapter whatsapp-cloud.ts và file test đăng ký từ nhánh channels
  • Thêm một dòng import tự đăng ký vào src/channels/index.ts
  • Cài @chat-adapter/whatsapp@4.29.0 với phiên bản ghim chính xác (không dùng range hay latest)
  • Chạy pnpm run build và test đăng ký để chứng minh kênh đã có trong registry
  • Hỏi tương tác 4 giá trị từ Meta (Phone Number ID, token System User vĩnh viễn, App Secret, Verify Token) rồi ghi vào .env (không ghi đè giá trị đã có)
  • Hướng dẫn webhook server dùng chung ở port 3000, đường dẫn /webhook/whatsapp-cloud, và cách expose bằng ngrok / Cloudflare Tunnel

Mọi bước đều idempotent nên chạy lại nhiều lần vẫn an toàn; skill còn nêu rõ lưu ý khi nâng cấp từ bản cũ (webhook đổi từ /webhook/whatsapp sang /webhook/whatsapp-cloud).

Phù hợp với ai

  • Developer muốn làm bot chăm sóc khách hàng hoặc trợ lý cá nhân trên WhatsApp bằng NanoClaw
  • Người muốn dùng API chính thức của Meta thay cho Baileys không chính thức
  • Ai đã cài bản adapter cũ và bị mất tin nhắn do đường dẫn webhook thay đổi
  • Người cần checklist xử lý sự cố: webhook verify, token hết hạn, cửa sổ 24 giờ

Ví dụ sử dụng

  1. Cài mới: yêu cầu "thêm kênh WhatsApp Cloud" → agent copy adapter, đăng ký, build, chạy test, rồi hỏi 4 thông tin từ dashboard Meta và lưu vào .env.
  2. Meta báo lỗi "Verify and save": kiểm tra service đã chạy chưa, WHATSAPP_VERIFY_TOKEN có khớp không, port 3000 có công khai không.
  3. Chạy được 1 ngày rồi lỗi 401: bạn đã dùng token tạm 24 giờ — tạo System User, phát token vĩnh viễn và thay WHATSAPP_ACCESS_TOKEN.

· · · Hướng dẫn cài đặt · · ·

Cài vào ứng dụng Claude (không cần terminal)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .claude/skills/add-whatsapp-cloud từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-whatsapp-cloud/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

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

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

  1. Mở terminal và clone repo: git clone https://github.com/nanocoai/nanoclaw.git
  2. Tạo thư mục skill: mkdir -p ~/.claude/skills
  3. Copy skill: cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/
  4. Vào project: cd nanoclaw và cài dependency: pnpm install
  5. Chạy Claude Code tại thư mục gốc project và nói: "thêm kênh WhatsApp Cloud".
  6. Trên Meta for Developers, tạo app loại Business, thêm sản phẩm WhatsApp, rồi chuẩn bị 4 giá trị: Phone Number ID, access token vĩnh viễn (System User), App Secret, Verify Token — dán vào các prompt.
  7. Nếu chạy local, expose port 3000 bằng ngrok http 3000, rồi đặt webhook URL trong dashboard Meta là https://<url-cua-ban>/webhook/whatsapp-cloud.
  8. Kiểm tra pnpm run build và test đăng ký đều xanh, sau đó dùng /manage-channels để gắn kênh vào agent group.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT