위챗 | Laney Docs

위챗(WeChat)은 중국 본토와 해외 중화권 고객이 가장 많이 쓰는 메신저입니다. 위챗 공식 계정(公众号)에 레이니 AI를 연동하면 고객이 공식 계정으로 보내는 메시지를 AI가 응대합니다. 연동하기 전에 인증된 서비스 계정(已认证服务号)이 먼저 있어야 합니다.

레이니는 중국 대륙 법인을 두지 않습니다. 그래서 위챗이 제공하는 위탁 운영 방식(第三方平台)이 아니라, 고객님 계정의 개발자 설정을 직접 맞추는 방식으로 연동합니다. 설정은 레이니가 관리자 권한을 받아 대신 진행하며, 보안상 외부에 권한을 주기 어려우면 고객님이 직접 설정하셔도 됩니다.

먼저, 내 위챗 계정이 어떤 종류인지 확인하세요

위챗으로 고객을 응대하려면 두 가지 조건이 꼭 맞아야 합니다.

서비스 계정(服务号) 이어야 합니다. 구독 계정(订阅号)은 고객 응대 메시지 기능(客服消息)이 열리지 않아 AI가 답을 보낼 수 없습니다.
인증된 계정(已认证) 이어야 합니다. 인증을 받지 않은 계정은 응대에 필요한 기능이 거의 막혀 있습니다.

이 조건을 만족하더라도, 계정을 어느 나라 사업자로 등록했는지에 따라 할 수 있는 일이 달라집니다. 계정은 등록 기준으로 두 종류로 나뉩니다.

구분	본토 계정	해외 계정
등록 기준	중국 사업자등록증(营业执照)	한국 등 해외 사업자등록증
만들 수 있는 계정	서비스 계정·구독 계정	서비스 계정만, 사업자당 1개
인증 비용	약 300위안 / 년	약 99달러 / 회
응대 대상	중국 본토 고객에게 바로 도달	기본은 본토 밖 고객. 본토 고객에게 보내려면 별도 신청 필요
고객 응대 메시지(客服消息)	사용 가능	사용 가능 (하루 500만 건까지)

내 계정이 어느 쪽인지 확인하는 방법: 위챗 공식 계정 플랫폼에 로그인한 뒤, 설정과 개발(设置与开发) 메뉴의 계정 정보(账号信息)에서 등록 주체와 인증 상태를 볼 수 있습니다. 한국 사업자로 직접 만든 계정이라면 해외 계정입니다.

해외 계정으로 만든 공식 계정은 기본적으로 중국 본토 밖에 있는 고객에게만 메시지를 보냅니다. 본토에 있는 고객에게 먼저 메시지를 보내려면 추가 신청이 필요하니, 응대 대상이 어디에 있는지 레이니 담당자와 먼저 상의해주세요.

사전 준비

인증된 서비스 계정(已认证服务号): 보유 및 인증 완료 상태
계정 종류 확인: 본토 계정인지 해외 계정인지 파악
관리자(管理员) 계정: 레이니에 권한을 넘길 때도, 직접 설정할 때도 관리자 로그인이 필요합니다
관리자 본인 확인 수단: 서버 설정·AppSecret 같은 중요한 작업마다 관리자(管理员)의 위챗 앱 스캔 또는 휴대폰 인증이 필요합니다

사이트	용도	URL
위챗 공식 계정 플랫폼(微信公众平台)	계정 관리, 개발자 설정, 서버 연동	mp.weixin.qq.com

연동 체크리스트

먼저 계정 종류와 인증을 확인한 뒤, 아래 두 방법 중 하나를 고릅니다.

방법 1. 레이니가 대신 설정 (기본)

레이니 담당자와 설정 일정 잡기
로그인 QR 스캔 1회 + AppSecret 인증번호 1회 전달

방법 2. 직접 설정 (보안 민감 고객)

레이니에서 설정값(서버 주소·토큰·키·IP) 받기
서버 설정 입력 및 IP 등록, 활성화
AppID·AppSecret 전달

연동 방법

연동은 두 가지 방법 중 하나로 진행합니다. 대부분은 레이니가 대신 설정하는 방법 1을 씁니다. 운영 권한을 외부에 주기 어렵다면 방법 2로 직접 설정하셔도 됩니다.

방법 1. 레이니가 대신 설정 (기본)

레이니가 관리자 권한을 받아 서버 설정을 대신 진행합니다. 카카오·라인처럼 레이니에 설정을 맡기는 방식이고, 관리자(管理员) 본인은 설정하는 동안 딱 두 번만 협조하면 됩니다.

설정 일정 잡기

레이니 담당자와 함께 진행할 시간을 정합니다. 화면을 공유하며 함께 진행합니다.

로그인 QR 스캔 (1회)

위챗 공식 계정은 로그인할 때 관리자(管理员) 본인의 위챗 앱으로 QR을 스캔해야 합니다. 레이니가 설정 화면을 열면, 관리자 본인이 QR을 한 번만 스캔해 로그인해주세요.

레이니가 서버 설정 진행

서버 주소·토큰·암복호화 키 입력과 IP 화이트리스트(IP白名单) 등록은 레이니가 모두 처리합니다. 따로 하실 일은 없습니다.

AppSecret 본인 확인 (1회)

레이니가 개발자 비밀번호(开发者密码(AppSecret))를 확인하거나 재설정할 때 관리자(管理员) 본인 확인이 필요합니다. 위챗 앱 스캔 또는 휴대폰 인증번호를 한 번만 처리해주시면 연동이 마무리됩니다.

테스트

실제 위챗 공식 계정으로 메시지를 보내 AI가 응대하는지 함께 확인합니다.

위챗은 서버 설정·AppSecret 같은 중요한 작업마다 관리자(管理员) 본인의 위챗 스캔(또는 휴대폰 인증)이 필요합니다. 운영자(运营者)는 일상 운영만 가능하고 서버 설정은 바꿀 수 없어서, 나중에 설정을 변경할 때도 관리자 확인이 한 번씩 필요합니다.

방법 2. 직접 설정 (보안 민감 고객)

운영 권한을 외부에 주지 않고, 고객님이 직접 설정한 뒤 레이니가 메시지를 보내는 데 필요한 값(AppID·AppSecret)만 전달하는 방법입니다.

서버 설정 변경과 AppSecret 발급·재설정에는 관리자(管理员) 본인의 위챗 스캔 또는 휴대폰 인증이 필요합니다. 설정하는 동안 관리자 계정 주인이 함께 있어야 합니다.

레이니에서 설정값 받기

레이니 담당자가 아래 네 가지 값을 전달합니다. 다음 단계에서 그대로 입력하니 받아두세요.

서버 주소(URL) — 메시지를 받을 레이니 주소
토큰(Token)
메시지 암복호화 키(EncodingAESKey)
등록할 IP 주소 목록

서버 설정 입력

위 안내의 직접 URL(/advanced/advanced?action=dev…)로 연 기본 설정 화면에서 서버 설정(服务器配置)을 엽니다. (메뉴 设置与开发 → 开发接口管理는 이제 이전 안내만 떠서 쓰지 않습니다.) 받은 값을 입력하세요.

서버 주소(服务器地址(URL))에 레이니 주소 입력
토큰(令牌(Token))과 메시지 암복호화 키(消息加解密密钥(EncodingAESKey)) 입력
메시지 형식은 평문 모드(明文模式)로 선택

암호화 모드(安全模式)는 켜지 마세요. 레이니는 현재 평문 모드(明文模式)로만 연동합니다.

IP 화이트리스트 등록

같은 기본 설정(基本配置) 화면에서 IP 화이트리스트(IP白名单)에 레이니가 알려준 IP 주소를 모두 추가합니다.

IP를 한 번에 많이 붙여넣으면 일부가 빠진 채 저장될 수 있습니다. 저장한 뒤 목록 개수가 받은 개수와 같은지 한 번 더 확인해주세요.

서버 설정 활성화

서버 설정에서 활성화(启用)를 누릅니다. 위챗이 레이니 주소로 연결을 확인하고, 레이니 서버가 정상 응답하면 연결이 완료됩니다.

AppID·AppSecret 전달

위 직접 URL로 연 기본 설정 화면에서 개발자 ID(开发者ID(AppID))를 확인합니다. 개발자 비밀번호(开发者密码(AppSecret))는 위챗이 한 번 발급한 뒤 다시 보여주지 않으므로, 저장해 둔 값이 있으면 그 값을 그대로 전달하는 게 가장 빠릅니다(재설정 불필요).

저장된 값이 없으면 재설정(重置) 으로 새로 발급합니다. 순서는 다음과 같습니다: 개발자 비밀번호 켜기(启用) 또는 재설정(重置) → 관리자 위챗 QR 스캔 → 공식 계정 로그인 비밀번호 입력(보안상 레이니가 대신 못 합니다) → 슬라이더 퍼즐 보안 인증(拖动滑块完成拼图) → 다음(下一步). 마지막 화면에 새 AppSecret(32자리)이 한 번만 표시됩니다.

슬라이더 퍼즐 보안 인증은 반드시 실제 브라우저에서 사람이 직접 드래그해 통과해야 합니다 — 자동화 도구로는 거의 실패합니다. 또 재설정(重置)은 즉시 적용되어, 같은 계정에 이미 연동된 다른 서비스가 있으면 그 서비스가 끊기니 주의하세요.

확인한 AppID·AppSecret 두 값을 레이니 담당자에게 안전하게 전달해주세요. 레이니 서버가 메시지를 보낼 때(access_token 발급) 꼭 필요한 값입니다.

테스트

실제 위챗 공식 계정으로 메시지를 보내 AI가 응대하는지 확인합니다.

확인 사항

실제 위챗 공식 계정으로 메시지를 보내 AI가 응대하는지 확인
레이니 수신함에서 대화 내역이 기록되는지 확인
해외 계정이라면, 응대할 고객이 본토에 있는지 해외에 있는지 레이니 담당자와 확인

위챗