Hainrixz/whatsapp-agentkit

해결하는 문제

WhatsApp AgentKit은 AI 기반 WhatsApp 고객 서비스 에이전트의 생성과 배포를 간소화합니다. 웹훅, 서명, 토큰, 배포와 같은 '배관 작업'을 제거하여, 비즈니스 오너가 코드를 작성하는 대신 비즈니스에 대한 질문에 답하기만 하면 기능하는 에이전트를 만들 수 있도록 합니다.

작동 방식

이 프로젝트는 Claude Code를 사용하여 개발 라이프사이클 전체를 자동화합니다. 설정 스크립트를 실행한 후, 사용자는 /build-agent 명령어를 통해 Claude Code와 상호작용하며 다섯 단계를 수행합니다:

1. 환경 설정: Python 확인 및 종속성 설치.
2. 인터뷰: Claude가 비즈니스 이름, 목적, 톤, 영업 시간, 가격/메뉴에 대해 사용자에게 질문합니다.
3. 구성: Claude가 FastAPI 서버, Claude API에 연결된 '뇌', 클라이언트 이력 메모리, 프로바이더 어댑터를 포함한 전체 프로젝트 구조를 생성합니다.
4. 테스트: 사용자는 로컬 터미널 채팅 시뮬레이터를 통해 에이전트를 테스트합니다.
5. 배포: GitHub 및 Railway에서 호스팅하는 절차를 안내합니다.

두 가지 WhatsApp 연결 방식을 지원합니다: Zernio (간단한 래퍼) 및 Meta Cloud API (공식 직접 접근). 중복 메시지와 타임아웃을 방지하기 위해 즉시 웹훅 응답 패턴과 이벤트 중복 제거를 구현했습니다.

대상 사용자

프로그래밍 지식이 깊지 않아도 WhatsApp에서 자주 묻는 질문, 예약, 리드 자격 평가를 처리할 수 있는 AI 에이전트가 필요한 비즈니스 오너 및 개발자(특히 LATAM 시장 대상).

주요 특징

• 노코드 설정: Claude Code와의 자연어 인터뷰를 통해 에이전트가 구축됩니다.
• 프로바이더 유연성: 패턴 어댑터를 사용해 Zernio와 Meta Cloud API 간에 쉽게 전환 가능.
• 신뢰성 있는 메시징: 이벤트 ID 중복 제거 및 비동기 처리로 중복 응답 방지.
• 보안 웹훅: HMAC-SHA256 서명 검증을 통해 부정한 메시지 삽입 방지.
• 메모리 지속성: 각 고객의 대화 이력을 개별적으로 유지.