> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 위챗 연결과 운영

> 위챗 서비스 계정을 에이전트에 연결해 위챗으로 들어온 문의에 AI가 답하게 할 수 있어요.

위챗 서비스 계정을 붙이면 고객이 위챗에서 보낸 문의에 에이전트가 답해요. 중국어권 고객을 그 고객이 늘 쓰는 메신저에서 맞을 수 있어요.

대화는 고객이 먼저 메시지를 보내야 시작해요. 계정마다 답할 에이전트와 [버전](https://docs.tryvox.co/docs/build/versioning.md)을 고르고, 여러 계정에 같은 에이전트를 연결해도 돼요.

> [!NOTE]
>
> 위챗 채널은 Beta예요. 정식 출시 전에 지원하는 메시지와 동작이 바뀔 수 있어요.

## 준비물

위챗 공식 계정 관리 화면에서 아래를 먼저 챙기세요. 메뉴 이름은 위챗 화면의 언어에 따라 달라요.

* **서비스 계정**: 고객 메시지에 답하는 API는 서비스 계정에서 써요.
* **AppID, AppSecret, 원시 ID**: AppID와 AppSecret은 **개발 > 기본 설정**에, 원시 ID는 계정 정보에 있어요. 원시 ID는 `gh_`로 시작해요.
* **IP 화이트리스트**: 같은 **기본 설정** 화면의 IP 화이트리스트에 `34.64.213.13`을 넣으세요. 이 주소가 없으면 vox.ai가 위챗에 답을 보내지 못해요.
* **Token과 EncodingAESKey**: **서버 설정**에서 Token을 정하고 EncodingAESKey를 만들어 두세요. 서버 설정의 저장은 vox.ai에서 채널을 만든 뒤에 해요.

AppSecret, Token, EncodingAESKey는 vox.ai 채널 설정에만 넣으세요.

## 계정 연결하기

위챗과 vox.ai 두 화면을 오가며 끝내요. vox.ai에 값을 넣어 채널을 만들고, vox.ai가 만든 수신 URL을 위챗 서버 설정에 넣은 뒤 활성화해요.

![위챗 채널 연결 화면에 AppID, 원시 ID, AppSecret, Token, EncodingAESKey, 에이전트가 채워진 모습](https://mintcdn.com/fleek/LQ4CrjhUoitvJ1sW/images/screens/operate/deploy/integrations/wechat/overview/create.webp?fit=max\&auto=format\&n=LQ4CrjhUoitvJ1sW\&q=85\&s=8b296580900a21116a937a161e21ebc1)

**1. vox.ai에서 채널 만들기**

**배포 > 채널**에서 **채널 연결**을 누르고 **위챗**의 **연결**을 누르세요. **이름**, **AppID**, **원시 ID**, **AppSecret**, **Token**, **EncodingAESKey**, **에이전트**를 채우고 **만들기**를 누르세요. vox.ai가 AppID와 AppSecret을 위챗에 확인하고, 맞으면 **중지** 상태로 만들어요.

**2. 위챗 서버 설정에 수신 URL 넣기**

채널 상세의 **설치 정보**에서 **수신 URL**을 복사해 위챗 **서버 설정**의 URL 칸에 넣으세요. Token과 EncodingAESKey는 vox.ai에 넣은 값과 같아야 해요. 메시지 암호화 방식은 안전 모드를 고르고, EncodingAESKey를 비웠다면 평문 모드를 고르세요. 저장한 뒤 서버 설정을 켜세요.

![위챗 채널 상세의 설치 정보에 수신 URL과 복사 버튼이 보이는 모습](https://mintcdn.com/fleek/LQ4CrjhUoitvJ1sW/images/screens/operate/deploy/integrations/wechat/overview/install-url.webp?fit=max\&auto=format\&n=LQ4CrjhUoitvJ1sW\&q=85\&s=98f261da236fdb87d5f4647fd528f284)

**3. 활성화하기**

vox.ai 채널 상세에서 **활성화**를 누르세요. 활성화한 뒤에 들어온 메시지부터 AI가 답해요.

## 연결 확인

* 위챗 앱에서 서비스 계정에 메시지를 보내 에이전트의 답이 오는지 확인하세요.
* 채널 상세의 **최근 수신**이 방금 시각으로 바뀌었는지 보세요.
* **기록**의 **채팅** 탭에서 채널을 위챗으로 걸러 대화가 남았는지 확인하세요.

사람이 답해야 할 때는 [채팅 기록](https://docs.tryvox.co/docs/operate/monitor/chats.md)에서 대화를 열어 이어받고 답장하세요. 위챗은 고객의 마지막 메시지 뒤 48시간 안에 메시지 5개까지만 보낼 수 있어요.

## 지원하는 메시지

위챗은 글자 메시지만 처리해요. 사진과 음성은 채팅 기록에 나타나지 않고 AI도 답하지 않으니, 고객에게 글자로 문의해 달라고 안내하세요.

## 설정 바꾸기와 연결 해제

**이름**, 계정 값, **에이전트**는 오른쪽 위 메뉴에서 **중지**를 누른 뒤 바꾸세요. 비밀값은 바꿀 때만 교체 칸에 넣으면 돼요. **최초 응답 담당**과 **AI 사용 허용**은 운영 중에도 바꿀 수 있어요.

> [!WARNING]
>
> **연결 해제**는 저장한 AppSecret, Token, EncodingAESKey를 지우고, 해제한 채널은 다시 활성화할 수 없어요. 위챗 서버 설정의 URL은 위챗에서 따로 바꾸세요.

## 문제가 생겼을 때

> [accordion] 채널 상태가 확인 필요이고 자격 확인 오류가 보여요
>
> AppID와 AppSecret을 다시 복사해 중지 상태에서 넣고 저장하세요. IP 화이트리스트에 `34.64.213.13`이 있는지도 보세요. 고친 뒤 오른쪽 위 메뉴의 **자격 다시 확인**을 누르세요.

> [accordion] 위챗 서버 설정을 저장할 때 URL 확인에 실패해요
>
> 수신 URL을 한 글자도 빼지 않고 붙였는지, Token이 vox.ai에 넣은 값과 같은지 확인하세요. 안전 모드라면 EncodingAESKey도 같아야 해요.

> [accordion] 고객 메시지는 기록에 있는데 답이 가지 않아요
>
> IP 화이트리스트를 먼저 확인하세요. 사람이 답장할 때는 고객의 마지막 메시지가 48시간 안이고 그 뒤로 보낸 메시지가 5개보다 적은지 보세요.

## 관련 문서

* [채널 개요](https://docs.tryvox.co/docs/operate/deploy/integrations/overview.md): 붙여 둔 채널의 상태와 마지막 수신 보기
* [에이전트 버전 관리](https://docs.tryvox.co/docs/build/versioning.md): 연결할 버전을 고르고 바꾸기
* [채팅 기록](https://docs.tryvox.co/docs/operate/monitor/chats.md): 위챗으로 들어온 대화를 찾고 이어받기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.