observe-whatsapp
WhatsApp 메시지 전송 및 웹훅 문제 디버깅
WhatsApp 프로덕션 문제를 효율적으로 해결합니다. 이 스킬은 메시지 전송 검사, 웹훅 실패 디버깅 및 Kapso 플랫폼에서 상태 확인을 실행하는 명령을 제공합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"observe-whatsapp" 사용 중입니다. +1234567890 전화번호에 대한 메시지 전송 확인
예상 결과:
+1234567890 에 대해 3 개의 메시지를 찾았습니다. 메시지 ID msg_abc123: 2024-01-15 10:30:00 에 전송됨. 메시지 ID msg_def456: 대기 중 (웹훅이 확인되지 않음). 메시지 ID msg_ghi789: 실패 - 수신자가 옵트아웃함.
"observe-whatsapp" 사용 중입니다. 지난 한 시간 동안 웹훅 전송 상태 표시
예상 결과:
웹훅 전송 요약: 45 개 성공, 3 개 실패. 실패한 전송: 10:15, 10:22, 10:45 에 웹훅 엔드포인트에서 503 Service Unavailable. 재시도 횟수: 3/3. 웹훅 서버 상태 확인 권장.
보안 감사
안전This skill is documentation-only (SKILL.md). Static analyzer flagged markdown code blocks as shell commands, but all 28 external_commands findings are false positives from code formatting. Network and env_access findings reference YAML frontmatter URLs and documented environment variable requirements, not actual code execution. No executable code exists in this skill.
품질 점수
만들 수 있는 것
프로덕션 인시던트 대응
활발한 인시던트 동안 WhatsApp 메시지가 고객에게 전송되지 않는 이유를 신속하게 조사합니다.
웹훅 디버깅
수신 메시지 또는 상태 업데이트가 수신되지 않는 이유를 이해하기 위해 웹훅 전송 시도를 검사합니다.
상태 모니터링
사용자에게 영향을 미치기 전에 문제를 사전에 감지하기 위해 전화번호 및 프로젝트에 대한 주기적인 상태 확인을 실행합니다.
이 프롬프트를 사용해 보세요
WhatsApp 메시지가 전송되었는지 확인해야 합니다. 전화번호는 +1234567890 입니다. 대화를 찾아서 전송 상태를 확인하는 것을 도와주세요.
웹훅 엔드포인트가 WhatsApp 으로부터 이벤트를 수신하는 것이 중지되었습니다. webhook-deliveries 스크립트를 사용하여 최근 전송 시도를 확인하고 오류 패턴을 식별하세요.
프로덕션에서 메시지 오류가 증가하고 있습니다. 전체 오류 트리아지를 실행하세요: 메시지 오류 확인, API 로그 검토, 웹훅 전송 실패 식별. 근본 원인을 요약하세요.
전화번호 ID <id> 에 대한 상태 확인을 실행하고 상태 보고서를 생성하세요. 실패한 상태 표시기 및 권장 수정 단계를 포함하세요.
모범 사례
- 오류와 근본 원인을 연관시키기 위해 항상 메시지 오류와 API 로그를 함께 확인하세요
- WhatsApp 통합에 대한 변경 사항을 배포하기 전에 사전에 상태 확인을 실행하세요
- 개별 메시지 문제를 조사할 때는 lookup-conversation 스크립트를 사용하여 전체 컨텍스트를 얻으세요
피하기
- 진단 스크립트를 짧은 간격으로 반복 실행하지 마십시오. API 액세스가 속도 제한될 수 있습니다
- 웹훅 설정 또는 구성 변경에 이 스킬을 사용하지 마십시오
- API 자격 증명이 유효하고 만료되지 않았는지 먼저 확인하지 않고 문제를 조사하지 마십시오