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