WhatsApp 문제
WhatsApp 비즈니스 통합 문제 해결 가이드.
일반적인 오류 메시지
| 오류 | 의미 |
|---|---|
| "Failed to connect WhatsApp account" | 연결 설정 실패 |
| "Failed to disconnect WhatsApp account" | 기존 연결을 제거할 수 없음 |
| "WhatsApp Signup Cancelled" | 사용자가 설정 팝업을 닫음 |
| "Failed to get state from backend" | 서버 통신 오류 |
연결 실패
증상: WhatsApp 비즈니스를 연결하려고 할 때 오류 발생
먼저 확인해야 할 사항
-
Facebook 비즈니스 계정 준비 완료
- Facebook 비즈니스 계정이 필요합니다.
- 계정이 인증되어야 합니다.
-
전화번호 요구 사항
- 번호는 SMS를 수신할 수 있어야 합니다.
- 번호가 이미 WhatsApp 개인 앱에 등록되어 있어서는 안 됩니다.
- 번호가 다른 WhatsApp 비즈니스 계정에서 사용되어서는 안 됩니다.
-
브라우저 팝업 설정
- AVA Streamliner의 팝업 허용
- 설정 중에 팝업을 닫지 마세요.
시도해 볼 사항
- 설정 → 커뮤니케이션 → WhatsApp으로 이동합니다.
- WhatsApp 연결을 클릭합니다.
- Facebook 팝업 흐름을 완료합니다.
- 성공 메시지를 기다립니다.
- 팝업이 예기치 않게 닫히면 다시 시도하세요.
메시지 전송 안 됨
증상: 투숙객이 WhatsApp 메시지를 받지 못함
연결 상태 확인
- 설정 → 커뮤니케이션 → WhatsApp으로 이동합니다.
- 상태가 "연결됨"으로 표시되는지 확인합니다.
- 연결된 전화번호가 올바른지 확인합니다.
템플릿 승인 확인
WhatsApp은 비즈니스 메시지에 대한 템플릿 승인을 요구합니다:
- WhatsApp Business Manager에서 메시지 템플릿이 승인되었는지 확인하세요.
- 승인된 템플릿은 ✓ 상태를 보여줍니다.
- 거부된 템플릿은 수정하여 다시 제출해야 합니다.
투숙객 전화번호 확인
- 번호에는 국가 코드가 포함되어야 합니다 (예: 미국의 경우 +1).
- 번호는 유효한 휴대폰 번호여야 합니다.
- 투숙객은 해당 번호에 WhatsApp이 설치되어 있어야 합니다.
샌드박스 모드 제한 사항
샌드박스 모드인 경우:
- 사전 승인된 테스트 번호만 메시지를 받을 수 있습니다.
- 프로덕션 모드로 전환하려면 지원 팀에 문의하세요.
템플릿 거부됨
증상: 템플릿이 "거부됨" 상태를 표시함
일반적인 거부 사유
| 사유 | 수정 |
|---|---|
| 홍보성 콘텐츠 | 판매 언어 제거 |
| 누락된 변수 | 필수 자리 표시자를 올바르게 추가 |
| 서식 문제 | WhatsApp 템플릿 가이드라인 준수 |
| 정책 위반 | WhatsApp 비즈니스 정책 검토 |
수정 단계
- WhatsApp Business Manager에서 거부 사유 검토
- 문제를 해결하기 위해 템플릿 편집
- 승인을 위해 다시 제출
- 검토를 위해 24-48시간 대기
연결 해제 실패
증상: "WhatsApp 계정 연결 해제 실패"
시도해 볼 사항
- 페이지 새로 고침
- 다시 연결 해제 시도
- 여전히 실패하면 5분 기다렸다가 다시 시도
여전히 작동하지 않나요?
지원 팀에 다음 정보를 포함하여 문의하세요:
- 호텔 이름
- 연결된 전화번호
- 오류 스크린샷
팝업 닫힘/취소됨
증상: "WhatsApp 가입 취소됨"
다음과 같은 경우 발생합니다:
- 설정을 완료하기 전에 Facebook 팝업을 닫았습니다.
- 브라우저가 팝업을 차단했습니다.
- 연결 시간이 초과되었습니다.
해결 방법
- 브라우저에서 AVA Streamliner에 대한 팝업 활성화
- WhatsApp 연결을 다시 클릭
- 팝업을 닫지 않고 전체 흐름 완료
- 닫기 전에 성공 메시지 대기
메시지 지연
증상: 투숙객이 메시지를 늦게 수신함
정상적인 지연
WhatsApp 메시지는 일반적으로 몇 초 내에 전달되지만 다음으로 인해 지연이 발생할 수 있습니다:
- 트래픽이 많은 기간
- 투숙객 위치의 네트워크 문제
- WhatsApp 서버 대기열
지속적으로 지연되는 경우
- WhatsApp 비즈니스 등급 확인 (높은 등급 = 더 빠른 전달)
- 계정 상태를 검토하려면 지원 팀에 문의하세요.
지원 팀에 문의해야 할 때
다음과 같은 경우 문의하세요:
- 올바른 설정에도 불구하고 연결이 지속적으로 실패함
- 메시지가 어떤 투숙객에게도 전달되지 않음
- 계정이 정지되거나 플래그가 지정됨
이메일: success@vouch-technologies.com
포함 사항:
- WhatsApp 설정 페이지의 스크린샷
- 메시지를 받지 못한 예시 전화번호
- 오류 메시지 (있는 경우)
관련 가이드
- AVA Streamliner의 설정 → 커뮤니케이션 → WhatsApp 참조