위챗 채널은 Beta예요. 정식 출시 전에 지원하는 메시지와 동작이 바뀔 수 있어요.
준비물
위챗 공식 계정 관리 화면에서 아래를 먼저 챙기세요. 메뉴 이름은 위챗 화면의 언어에 따라 달라요.- 서비스 계정: 고객 메시지에 답하는 API는 서비스 계정에서 써요.
- AppID, AppSecret, 원시 ID: AppID와 AppSecret은 개발 > 기본 설정에, 원시 ID는 계정 정보에 있어요. 원시 ID는
gh_로 시작해요. - IP 화이트리스트: 같은 기본 설정 화면의 IP 화이트리스트에
34.64.213.13을 넣으세요. 이 주소가 없으면 vox.ai가 위챗에 답을 보내지 못해요. - Token과 EncodingAESKey: 서버 설정에서 Token을 정하고 EncodingAESKey를 만들어 두세요. 서버 설정의 저장은 vox.ai에서 채널을 만든 뒤에 해요.
계정 연결하기
위챗과 vox.ai 두 화면을 오가며 끝내요. vox.ai에 값을 넣어 채널을 만들고, vox.ai가 만든 수신 URL을 위챗 서버 설정에 넣은 뒤 활성화해요.
1
vox.ai에서 채널 만들기
배포 > 채널에서 채널 연결을 누르고 위챗의 연결을 누르세요. 이름, AppID, 원시 ID, AppSecret, Token, EncodingAESKey, 에이전트를 채우고 만들기를 누르세요. vox.ai가 AppID와 AppSecret을 위챗에 확인하고, 맞으면 중지 상태로 만들어요.
2
위챗 서버 설정에 수신 URL 넣기
채널 상세의 설치 정보에서 수신 URL을 복사해 위챗 서버 설정의 URL 칸에 넣으세요. Token과 EncodingAESKey는 vox.ai에 넣은 값과 같아야 해요. 메시지 암호화 방식은 안전 모드를 고르고, EncodingAESKey를 비웠다면 평문 모드를 고르세요. 저장한 뒤 서버 설정을 켜세요.
3
활성화하기
vox.ai 채널 상세에서 활성화를 누르세요. 활성화한 뒤에 들어온 메시지부터 AI가 답해요.
연결 확인
- 위챗 앱에서 서비스 계정에 메시지를 보내 에이전트의 답이 오는지 확인하세요.
- 채널 상세의 최근 수신이 방금 시각으로 바뀌었는지 보세요.
- 기록의 채팅 탭에서 채널을 위챗으로 걸러 대화가 남았는지 확인하세요.
지원하는 메시지
위챗은 글자 메시지만 처리해요. 사진과 음성은 채팅 기록에 나타나지 않고 AI도 답하지 않으니, 고객에게 글자로 문의해 달라고 안내하세요.설정 바꾸기와 연결 해제
이름, 계정 값, 에이전트는 오른쪽 위 메뉴에서 중지를 누른 뒤 바꾸세요. 비밀값은 바꿀 때만 교체 칸에 넣으면 돼요. 최초 응답 담당과 AI 사용 허용은 운영 중에도 바꿀 수 있어요.문제가 생겼을 때
채널 상태가 확인 필요이고 자격 확인 오류가 보여요
채널 상태가 확인 필요이고 자격 확인 오류가 보여요
AppID와 AppSecret을 다시 복사해 중지 상태에서 넣고 저장하세요. IP 화이트리스트에
34.64.213.13이 있는지도 보세요. 고친 뒤 오른쪽 위 메뉴의 자격 다시 확인을 누르세요.위챗 서버 설정을 저장할 때 URL 확인에 실패해요
위챗 서버 설정을 저장할 때 URL 확인에 실패해요
수신 URL을 한 글자도 빼지 않고 붙였는지, Token이 vox.ai에 넣은 값과 같은지 확인하세요. 안전 모드라면 EncodingAESKey도 같아야 해요.
고객 메시지는 기록에 있는데 답이 가지 않아요
고객 메시지는 기록에 있는데 답이 가지 않아요
IP 화이트리스트를 먼저 확인하세요. 사람이 답장할 때는 고객의 마지막 메시지가 48시간 안이고 그 뒤로 보낸 메시지가 5개보다 적은지 보세요.
관련 문서
- 채널 개요: 붙여 둔 채널의 상태와 마지막 수신 보기
- 에이전트 버전 관리: 연결할 버전을 고르고 바꾸기
- 채팅 기록: 위챗으로 들어온 대화를 찾고 이어받기