채널 - WhatsApp 구성
요약
WhatsApp 채널은 WeChat과 마찬가지로 QR 코드로 연결하므로 Hermes Agent를 WhatsApp 대화에 빠르게 추가할 수 있습니다. 콘솔의 채널 섹션에서 WhatsApp을 선택해 QR 코드를 생성한 뒤 휴대폰의 WhatsApp으로 스캔하면 대화를 시작할 수 있습니다. WhatsApp이 설치된 휴대폰과 구성된 모델(또는 플랜에 포함된 월간 모델 크레딧)이 필요합니다. 하나의 에이전트를 여러 채널에 동시에 연결해 동일한 페르소나와 장기 메모리를 공유할 수 있습니다.
WhatsApp 채널은 WeChat과 유사한 QR 코드 액세스를 사용하며 Hermes Agent를 WhatsApp 대화에 빠르게 연결하는 데 적합합니다.
이 페이지에서는 다음을 다루고 있습니다.
-
휴대폰에서 WhatsApp으로 QR 코드를 스캔하여 액세스 승인
-
WhatsApp에서 Hermes Agent와 채팅 중
단계
1. 콘솔에 들어가세요
LightVela에 로그인하고 오른쪽 상단의 "My Hermes"를 클릭하여 콘솔에 들어간 후 "채널" 버튼을 찾으세요.
2. WhatsApp 채널을 선택합니다.
WhatsApp 카드를 찾아 "+ 연결"을 클릭하세요.
3. 휴대폰에서 WhatsApp으로 QR 코드를 스캔하세요.
-
휴대폰에서 WhatsApp을 엽니다.
-
오른쪽 상단에 있는 "카메라" 버튼을 탭하세요.
-
컴퓨터 화면에서 QR 코드를 스캔하세요.

- 휴대폰의 지시에 따라 연결을 완료하세요.
4. WhatsApp에서 자신을 찾으세요

자신과 채팅하세요. 그게 바로 여러분의 봇입니다.
봇과의 채팅을 열고 테스트 메시지를 보냅니다.
Hi몇 초 내에 Hermes Agent 응답을 받게 됩니다.

성공 상태
-
콘솔의 "연결된 채널" 목록에 "WhatsApp"이 포함되어 있습니다.
-
해당 봇은 WhatsApp 연락처에서 찾을 수 있습니다.
-
Hermes Agent는 메시지를 보낸 후 응답합니다.
지원되는 메시지 유형
액세스가 성공한 후 WhatsApp 봇은 기본 문자 메시지를 수신하고 응답할 수 있으며 다음과 같이 더 많은 메시지 유형을 지원합니다.
| WhatsApp 봇이 지원하는 메시지 유형 | 지원됨 |
|---|---|
| 문자 메시지 받기 | ✅ 지원됨 |
| 이미지 및 비디오 수신 | ✅ 지원됨 |
| 파일 받기 | ✅ 지원됨 |
| 문자 메시지로 답장하기 | ✅ 지원됨 |
| 이미지와 동영상으로 답장하기 | ✅ 지원됨 |
| 파일로 답장하기 | ✅ 지원됨 |
| 사전에 메시지 보내기(예: 예약된 알림) | ✅ 지원됨 |
FAQ
| 이슈 | 가능한 원인 | 솔루션 |
|---|---|---|
| WhatsApp에 연결할 수 없습니다 | 전화번호 형식이 잘못되었거나 WhatsApp 비즈니스 구성이 불완전합니다. | +1 또는 +86과 같은 완전한 국제 형식을 사용하고 WhatsApp 비즈니스/메타 구성이 완료되었는지 확인하십시오. |
| 인증코드를 받지 못했습니다 | 사용할 수 없는 전화번호, 네트워크 지연 또는 WhatsApp 인증 제한 | 전화번호가 WhatsApp 메시지를 받을 수 있는지 확인하세요. 몇 분 정도 기다렸다가 다시 시도하세요. |
| 인증 코드를 입력한 후 유효하지 않은 것으로 표시됩니다. | 코드가 만료되었거나 잘못 입력되었습니다. | 새 코드를 요청하고 추가 공백이 없는지 확인하세요. |
| 액세스 후 콘솔에 응답이 없습니다. | 승인 또는 구성의 동기화가 완료되지 않았습니다. | 상태를 확인하려면 콘솔을 새로 고치십시오. 액세스에 실패하면 다시 시도하세요. |
| WhatsApp에서 봇 연락처를 찾을 수 없습니다. | 봇의 번호가 저장되지 않았거나 채팅이 시작되지 않았습니다. | 봇의 번호를 저장하거나 콘솔에서 제공하는 링크/QR 코드를 통해 채팅을 엽니다. |
| 메시지를 보낸 후 응답이 없습니다. | 모델이 구성되지 않았거나 체험 크레딧이 소진되었거나 WhatsApp 채널이 성공적으로 연결되지 않았습니다. | "1. 모델" 카드에서 "현재 모델" 상태를 확인하고 WhatsApp 채널이 연결된 것으로 표시되는지 확인하세요. |
| 이미지, 파일, 음성 메시지를 받을 수 없습니다. | 미디어 권한, 형식 또는 채널 기능 제한 | 파일 형식이 지원되는지 확인하세요. 음성을 인식할 수 없는 경우 음성-텍스트/미디어 처리가 활성화되어 있는지 확인하세요. |
| 사전 메시지 실패 | WhatsApp은 메시지 템플릿 및 대화 창을 통해 사전 메시지를 제한합니다. | 사용자가 봇과 대화를 시작했는지 확인합니다. 대화 창이 만료된 경우 승인된 메시지 템플릿을 사용하세요. |
| 연결을 해제하는 방법 | — | "연결된 채널" 목록에서 해당 WhatsApp 레코드를 삭제합니다. |
| 동일한 WhatsApp 번호를 여러 Hermes Agent 인스턴스에 연결할 수 있나요? | 권장되지 않습니다. 하나의 WhatsApp 번호는 하나의 Hermes Agent에 바인딩되어야 합니다. | 여러 개의 Hermes Agent 인스턴스가 필요한 경우 별도의 WhatsApp 번호를 사용하세요. |
채널 노트
-
메시지 유형: 텍스트, 이미지, 동영상, 파일, 음성 메시지 등을 지원합니다. 위의 '지원되는 메시지 유형'을 참조하세요.
-
그룹 채팅 지원: 그룹 채팅은 현재 지원되지 않습니다. 1:1 대화만 지원됩니다.
-
연결 중단: 오랫동안 응답이 없으면 승인이 취소되었음을 의미할 수 있습니다. 콘솔로 돌아가서 액세스를 다시 승인하세요.
다음 단계
-
채널 구성 - Discord — 커뮤니티 운영 및 개발자 커뮤니티
-
채널 구성 - Slack — 팀 협업, 작업 공간 알림 및 채널 워크플로
-
채널 구성 - QQ — 봇이 수동으로 생성되고 AppID/AppSecret을 통해 통합됨
-
채널 구성 - WeCom — 기업 내부 협업 및 업무 환경
-
스킬 구성 — Hermes Agent 기능 확장
마지막 업데이트: 2026-08-31
채널 - Telegram 구성
Telegram 채널은 봇 토큰으로 연결하므로 Hermes Agent를 Telegram 다이렉트 메시지나 그룹에 빠르게 추가할 수 있습니다. Telegram의 BotFather에서 봇을 만들고 봇 토큰을 복사한 뒤 LightVela 콘솔의 채널 섹션에 붙여넣으세요.
채널 - Discord 구성
Discord 채널은 봇 인증 방식으로 연결합니다. Hermes Agent를 Discord 서버에 추가해 질문에 답하거나 업무를 지원하고 커뮤니티 활동을 돕는 데 적합합니다. Discord 개발자 포털에서 애플리케이션과 봇을 만들고 자격 증명을 발급받아 LightVela 콘솔의 채널 섹션에 붙여넣은 다음, 대상 서버에 봇…