WhatsApp 설정
Claw Buff AI 에이전트를 WhatsApp에 연결하는 단계별 가이드
WhatsApp 연동은 베타 상태예요. WhatsApp Web 프로토콜(Baileys)을 사용하며, 이는 공식 API가 아닙니다. 아래 중요 안내를 참고하세요.
Claw Buff AI 에이전트를 WhatsApp에 연결하면, 사용자가 일반 연락처처럼 에이전트와 대화할 수 있어요. 설정은 약 5분이면 완료됩니다.
사전 준비
- WhatsApp 계정 (전용 전화번호 사용을 강력히 권장해요)
- QR 코드 스캔을 위한 스마트폰
- 배포된 Claw Buff 에이전트 (시작하기)
1단계: Claw Buff에 연결하기
- Claw Buff 콘솔 → 채널 페이지를 여세요
- WhatsApp 카드를 찾고 연결을 클릭하세요
- QR 코드 생성을 클릭하세요
화면에 QR 코드가 표시돼요.
2단계: QR 코드 스캔하기
스마트폰에서 WhatsApp 열기
⋮ 메뉴 (우측 상단) 또는 설정을 열고, 연결된 기기 → 기기 연결을 탭하세요. 일부 버전에서는 프로필 이름 옆의 QR 아이콘을 탭해도 돼요.
QR 코드 스캔하기
스마트폰 카메라로 콘솔에 표시된 QR 코드를 스캔하세요. 자동으로 연결이 설정돼요.
연결 확인하기
콘솔에 상태가 연결됨으로 표시돼요. 연결된 전화번호를 확인할 수 있어요.
3단계: 대화 시작하기
다른 WhatsApp 계정에서 연결된 WhatsApp 번호로 메시지를 보내 보세요. AI 에이전트가 응답할 거예요!
WhatsApp 봇에는 전용 전화번호를 사용하는 것을 권장해요. 이렇게 하면 개인 WhatsApp과 분리되어 개인 계정에 대한 위험을 방지할 수 있어요.
지원 기능
| 기능 | 지원 여부 |
|---|---|
| 다이렉트 메시지 | 지원 |
| 그룹 채팅 | 지원 |
| 서식 지원 | 지원 |
| 파일 첨부 | 지원 |
| 음성 메시지 | 지원 예정 |
중요 안내
베타 상태
WhatsApp 연동은 Baileys 라이브러리(WhatsApp Web 프로토콜)를 사용해요. 이는 공식 WhatsApp API가 아니므로 다음 사항에 유의하세요:
- 계정 위험 — WhatsApp이 비공식 API를 사용하는 계정을 제한할 수 있어요. 개인 번호가 아닌 전용 번호를 사용하세요
- 세션 만료 — 연결된 세션은 약 30일간 비활성 상태가 지속되면 만료돼요. QR 코드를 다시 스캔해야 해요
- SLA 없음 — WhatsApp의 프로토콜 변경으로 연결이 일시적으로 중단될 수 있어요
전용 번호 사용 권장
WhatsApp 봇에는 별도의 전화번호를 사용하는 것을 강력히 권장해요. 선택지:
- 선불 SIM 카드
- Google Voice 번호
- SMS 인증이 가능한 VoIP 번호
Cloud API 대안
공식 API가 필요한 프로덕션 용도로는 향후 릴리스에서 WhatsApp Cloud API 지원이 계획되어 있어요. Meta의 공식 Business API를 사용하며, 적절한 SLA와 계정 위험이 없는 환경을 제공할 예정이에요.
자주 묻는 질문
1. QR 코드가 만료되었나요?
QR 코드는 약 60초 후에 만료돼요. 콘솔에서 QR 코드 생성을 다시 클릭하여 새 코드를 받으세요.
2. 연결이 자주 끊기나요?
- 스마트폰이 인터넷에 연결되어 있는지 확인하세요
- WhatsApp이 최신 버전으로 업데이트되었는지 확인하세요
- 스마트폰이 오랜 시간 오프라인이었다면 세션을 다시 연결해야 할 수 있어요
3. 메시지가 전달되지 않나요?
- 수신자 번호가 E.164 형식인지 확인하세요 (예: +15551234567)
- 그룹 메시지는 봇 번호가 그룹의 멤버여야 해요
- 콘솔의 채널 페이지에서 오류 세부 정보를 확인하세요