LightVela

채널 - 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 코드를 스캔하세요.

  1. 휴대폰에서 WhatsApp을 엽니다.

  2. 오른쪽 상단에 있는 "카메라" 버튼을 탭하세요.

  3. 컴퓨터 화면에서 QR 코드를 스캔하세요.

  1. 휴대폰의 지시에 따라 연결을 완료하세요.

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 대화만 지원됩니다.

  • 연결 중단: 오랫동안 응답이 없으면 승인이 취소되었음을 의미할 수 있습니다. 콘솔로 돌아가서 액세스를 다시 승인하세요.


다음 단계

마지막 업데이트: 2026-08-31