Hermes Agent와 WhatsApp Business Cloud 연동으로 AI 비서 구축하기

안녕하세요! AI 에이전트와 자동화에 관심이 많은 여러분, 오늘은 정말 흥미로운 소식을 가져왔습니다. 바로 Hermes Agent와 WhatsApp Business Cloud의 새로운 통합 기능에 대한 이야기입니다. 이 영상을 보고 저도 바로 VivaSport 프로젝트에 적용할 수 있을 것 같다는 생각이 들었어요! 내 WhatsApp이 나를 위해 생각하고, AI 에이전트가 나에게 직접 메시지를 보내준다면 얼마나 편리할까요?

Hermes Agent는 Nuse Research에서 개발한 오픈소스 AI 에이전트입니다. 제 컴퓨터에서 백그라운드로 실행되면서 저의 프로젝트를 학습하고, 과거에 문제를 해결했던 방법을 기억하는 똑똑한 친구죠. 스케줄링된 작업을 수행하고, 스스로 새로운 스킬을 구축할 수 있으며, 무엇보다 Telegram, Discord, Slack, Signal, 이메일, 그리고 WhatsApp과 같은 다양한 메시징 앱과 연결될 수 있다는 점이 매력적입니다.

이제는 AI의 도움이 필요할 때마다 별도의 앱을 열 필요 없이, 그냥 메시지를 보내면 에이전트가 채팅창에서 바로 답장해주는 세상이 온 겁니다!

✨ 새로운 WhatsApp Business Cloud 통합의 핵심

가장 중요한 업데이트는 바로 Hermes Agent가 프로덕션 수준의 WhatsApp Business Cloud 통합을 지원한다는 점입니다. 이는 개인 또는 팀을 위한 프라이빗 WhatsApp 봇으로 사용할 수도 있고, 고객 대면 지원 봇으로도 활용할 수 있음을 의미해요.

주요 기능과 특징

공식 Meta 지원: 기존의 비공식적인 연동 방식(Bailey’s bridge)과는 달리, Meta의 공식 지원 경로를 통해 밴 리스크 없이 안정적으로 운영할 수 있습니다.
간편한 설정: Hermes WhatsApp Cloud 명령어를 실행하면 단계별로 쉽게 설정할 수 있습니다.
풍부한 사용자 경험:
- 보안 웹훅: 메시지 보안을 강화합니다.
- 미디어 및 음성 지원: FFmpeg를 설치하면 음성 메시지가 WhatsApp의 녹음 파일 형태로 전송됩니다.
- 읽음 확인: 메시지를 읽으면 파란색 이중 체크 표시가 나타납니다.
- 입력 표시: 에이전트가 생각 중일 때 ‘입력 중’ 표시가 나타납니다.
- 대화형 승인 버튼: 에이전트의 확인이 필요할 때 탭할 수 있는 버튼이 제공됩니다. 마치 정식 앱을 사용하는 듯한 느낌을 줍니다.

🛠️ 연동을 위한 준비물

이 멋진 기능을 사용하기 위해서는 몇 가지 준비가 필요합니다.

Meta 비즈니스 계정: 개인 WhatsApp이 아닌 business.facebook.com에서 비즈니스 계정을 생성해야 합니다.
WhatsApp이 활성화된 Meta 앱: developers.facebook.com/apps에서 앱을 생성하고 WhatsApp 기능을 활성화해야 합니다.
컴퓨터를 인터넷에 노출할 수 있는 방법: Cloudflare Tunnel과 같은 무료 도구를 사용하여 로컬 Hermes 포트를 외부로 노출합니다. 별도의 포트 포워딩이나 도메인이 필요 없어 매우 편리합니다.
(선택 사항) FFmpeg 설치: 음성 답변을 WhatsApp 음성 메모(녹색 파형) 형식으로 받고 싶다면 설치하는 것이 좋습니다.

영상을 통해 Julian Goldie 님은 상세한 설정 과정을 보여주지만, 제가 가장 중요하다고 생각하는 핵심 포인트들을 정리해봤습니다.

1. Meta 앱 생성 및 설정

developers.facebook.com/apps에서 앱을 생성하고 ‘Connect with customers through WhatsApp’ 사용 사례를 선택합니다.
API 설정 페이지에서 WhatsApp 비즈니스 계정이 연결되어 있는지 확인합니다.

2. 필수 값 수집 (흔히 하는 실수 주의!)

Phone Number ID: 절대 실제 전화번호가 아닙니다! ‘From’ 드롭다운 아래에 있는 15~17자리 내부 ID를 복사해야 합니다. 많은 분이 여기서 실수를 한다고 해요.
Access Token: EAA로 시작하는 100자 이상의 토큰입니다. 테스트용은 24시간만 유효하므로, 실제 운영할 봇이라면 영구 시스템 사용자 토큰을 생성해야 합니다.
App Secret: 설정 > 기본에서 확인할 수 있는 32자리 코드입니다. 메시지 인증에 사용되므로 비밀번호처럼 안전하게 관리해야 합니다.

3. Cloudflare Tunnel을 통한 노출

Cloudflare Tunnel을 설치하고 Hermes 포트(localhost:3000 등)를 가리키도록 설정하면 trycloudflare.com으로 끝나는 공용 링크를 받게 됩니다.
이 링크가 Meta가 메시지를 보내는 콜백 URL이 됩니다. 안정적인 링크를 위해 무료 ‘Named Tunnel’을 사용하는 것을 추천합니다.

4. Meta Webhook 설정

Hermes 게이트웨이를 시작한 후, Meta 대시보드의 Webhook 섹션에서 콜백 URL(Cloudflare Tunnel 링크 + /whatsapp/webhook)과 Verify Token을 입력하고 저장합니다.
중요: Webhook 필드에서 messages 필드를 구독해야 Meta가 Hermes로 들어오는 메시지를 보내기 시작합니다. 이 부분을 놓치면 봇이 작동하지 않습니다.

5. Hermes Agent 설치 및 연동

Hermes 데스크톱 설치 프로그램을 실행하거나, curl 명령어를 통해 커맨드라인으로 설치할 수 있습니다. Python, Node, FFmpeg 등 필요한 모든 의존성을 자동으로 처리해줍니다.
설치 후 Hermes WhatsApp Cloud Wizard를 실행하여 앞서 얻은 값들을 입력하면 연동이 완료됩니다.

💡 프로 팁과 주의사항

전용 전화번호 사용: 개인 번호가 아닌 봇 전용 번호를 사용하는 것이 좋습니다.
개발 모드 제한: 개발 모드에서는 최대 5개의 승인된 번호로만 메시지를 보낼 수 있으니, 테스트용으로 자신의 번호를 먼저 추가하세요.
24시간 메시지 규칙: Meta는 사용자가 봇에 메시지를 보낸 후 24시간 이내에만 무료 메시지를 보낼 수 있도록 제한합니다. 일반적인 채팅에는 문제가 없습니다.
문제 발생 시: 대부분 오래된 터널 링크나 일치하지 않는 Verify Token 때문인 경우가 많습니다.

✨ VivaSport 프로젝트에 적용한다면?

저는 이 Hermes Agent를 활용하여 VivaSport 사용자들에게 실시간으로 중요한 대회 정보나 마일리지 혜택을 WhatsApp을 통해 푸시해주는 시스템을 구축하고 싶다는 생각이 들었어요. 예를 들어, 사용자가 특정 이벤트에 등록하면 Hermes Agent가 WhatsApp으로 “이벤트 등록이 완료되었습니다!” 메시지를 보내주고, 대회 시작 전 알림도 보내줄 수 있겠죠. 또한, 사용자 문의에 AI 챗봇이 바로 응답하여 고객 서비스 효율을 높이는 데에도 큰 도움이 될 것 같습니다.

이처럼 Hermes Agent와 WhatsApp Business Cloud의 통합은 AI 에이전트의 활용 범위를 크게 확장시켜 줄 수 있는 매우 강력한 기능입니다. 여러분도 이 가이드를 통해 자신만의 AI 비서를 구축해보는 건 어떨까요?