메인 콘텐츠로 건너뛰기
WhatsApp Web과 마찬가지로 QR 코드를 스캔하여 WhatsApp을 Claw 인스턴스에 연결합니다.

​
사전 요구 사항

WhatsApp은 사용자의 실제 전화번호를 사용합니다. 봇을 통해 전송된 메시지는 사용자의 WhatsApp 계정에서 보낸 것으로 표시됩니다. 분리를 원하시면 전용 번호를 사용하세요.
VoIP 번호는 지원되지 않습니다. WhatsApp은 실제 SIM 기반 전화번호가 필요합니다. 가상 번호(Google Voice, Skype 등)는 QR 코드 페어링에 작동하지 않습니다.

​
설정 가이드

1

WhatsApp 구성 저장

  1. Claw Dashboard로 이동합니다
  2. 인스턴스의 settings icon을 클릭합니다
  3. IM Integrations 탭을 엽니다
  4. WhatsApp 섹션을 확장합니다
  5. Access Policy(허용 목록 권장)를 구성합니다
  6. 먼저 Save를 클릭합니다 — QR 코드를 스캔하기 전에 구성을 저장해야 합니다
2

QR 코드 스캔

  1. Scan QR Code 버튼을 클릭합니다
  2. QR 코드가 나타납니다 (~60초 동안 유효)
  3. 휴대폰에서 WhatsApp → 설정 → 연결된 기기 → 기기 연결을 엽니다
  4. 화면에 표시된 QR 코드를 스캔합니다
  5. 연결이 설정될 때까지 기다립니다
3

액세스 정책 구성

WhatsApp은 allowlist(허용 목록) 정책을 사용합니다 — 지정한 전화번호만 AI 봇과 상호 작용할 수 있습니다.LemonData 대시보드에서 허용된 전화번호를 추가합니다(국제 표준 형식, 예: +1234567890).
다른 플랫폼과 달리 WhatsApp은 페어링 메커니즘을 지원하지 않습니다. 허용된 연락처를 명시적으로 추가해야 합니다.
4

채팅 시작

허용된 연락처에서 연결된 WhatsApp 번호로 메시지를 보냅니다 — AI가 응답할 것입니다!

​
그룹 설정

WhatsApp 그룹이 지원됩니다. IM Integrations 탭에서 그룹 동작을 구성하세요:
설정옵션설명
Group PolicyOpen (기본값) / Allowlist / Disabled그룹에서 봇을 트리거할 수 있는 사용자를 제어합니다
Require @mentionOn / Off@멘션되었을 때만 봇이 응답합니다
Group IDs그룹 JID 목록특정 그룹으로 제한 (비어 있음 = 모든 그룹)
Group Allowed Users전화번호 목록이 사용자들만 봇을 트리거할 수 있음 (허용 목록 모드)
그룹 허용 목록의 전화번호에는 E.164 형식을 사용하세요 (예: +1234567890).

​
문제 해결

새 코드를 생성하려면 Scan QR Code를 다시 클릭하세요. QR 코드는 약 60초 후에 만료됩니다.
WhatsApp은 활동이 없을 경우 연결된 기기의 연결을 해제할 수 있습니다. QR 코드를 다시 스캔하여 다시 연결하세요.
  • 발신자의 번호가 허용 목록에 있는지 확인하세요 (허용 목록 정책을 사용하는 경우)
  • 인스턴스가 실행 중인지 확인하세요
  • LemonData 잔액을 확인하세요