WhatsApp 계정 에이전트 사용 가이드

본 서비스는 WhatsApp 연결된 기기 기능을 사용하며, WhatsApp 공식 Business API가 아닙니다. 계정 연결 방식은 WhatsApp의 공식 지원을 받지 않습니다. 프로토콜 변경, 기기 해제 또는 계정 제한으로 인해 중단될 수 있습니다. 본인이 소유한 계정만 연결하고, WhatsApp 약관을 준수하며, 스팸 메시지 또는 동의 없는 대량 발송에 사용하지 마십시오.

​

배포 및 본인 승인

1. 콘솔에서 「WhatsApp 계정 에이전트」 애플리케이션을 생성하고, 구독을 활성화한 후 배포를 클릭합니다. 인스턴스 리소스는 플랫폼에서 자동으로 구성됩니다.
2. 인스턴스가 준비된 후 관리 페이지에서 QR 코드를 확인합니다. 본인 휴대폰에서 WhatsApp 설정 → 연결된 기기 → 기기 연결을 열고 스캔합니다. 또는 본인 전화번호를 입력하여 페어링 코드를 요청한 후, 휴대폰에서 확인할 수도 있습니다.
3. 관리 페이지 상태가 「연결됨」으로 변경된 후, 전용 MCP 주소와 Bearer 액세스 토큰을 복사합니다.
4. 계정에서 로그아웃하면 연결된 기기를 해제하고 로컬 세션 및 기록을 지우려고 시도합니다. 로그아웃 결과가 확실하지 않은 경우, 먼저 휴대폰의 「연결된 기기」에서 해당 기기를 해제하십시오. 인스턴스를 삭제하면 해당 영구 볼륨이 제거됩니다.

​

인증 및 기능

​

MCP

​

REST 예시

BASE='https://whatsapp-bot-<实例 ID>.app.acedata.cloud'
TOKEN='<管理页显示的访问令牌>'

curl "$BASE/api/auth/status" -H "Authorization: Bearer $TOKEN"
curl "$BASE/api/chats?limit=20" -H "Authorization: Bearer $TOKEN"
curl "$BASE/api/chats/123%40s.whatsapp.net/messages?limit=20" -H "Authorization: Bearer $TOKEN"

curl -X POST "$BASE/api/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: my-confirmed-message-20261004-1" \
  -H 'Content-Type: application/json' \
  -d '{"target":"123@s.whatsapp.net","action":"text","text":"你好"}'

​

실시간 이벤트

​

일반적인 상태