Repolode
aldinokemal

aldinokemal/go-whatsapp-web-multidevice

GoWA는 여러 계정, 웹훅, MCP, Chatwoot 연동을 지원하는 Go 기반 셀프 호스팅 WhatsApp REST API입니다.

대체할 수 있는 제품:Twilio

스타
4,942
포크
1,199
열린 이슈
47
마지막 커밋
14시간 전

어떤 프로젝트인가요?

GoWA는 WhatsApp Web의 멀티 디바이스 프로토콜을 HTTP REST API로 감싸, 개발자가 일반적인 HTTP 호출로 메시지를 보내고 그룹을 관리하며 WhatsApp 계정에서 이벤트를 받을 수 있게 합니다. 단일 서버에서 여러 WhatsApp 계정을 동시에 연결하고 관리할 수 있으며, X-Device-Id 헤더나 device_id 매개변수로 기기별 엔드포인트를 선택합니다.

텍스트, 미디어, 스티커, 투표, 반복 예약 전송, 고스트 멘션을 지원합니다. 수신 이벤트는 HMAC-SHA-256 서명이 포함된 웹훅 URL로 전달되며, 이벤트 유형이나 채팅 및 발신자 JID를 기준으로 필터링할 수 있습니다. 또한 서버는 AI 에이전트가 WhatsApp 작업을 호출할 수 있도록 /mcp에 MCP 엔드포인트를 제공하며, 대화를 지원팀 받은편지함으로 연결하는 선택형 Chatwoot 연동도 포함합니다.

이 프로젝트는 Go로 작성되었으며 바이너리, Docker 이미지, n8n 커뮤니티 노드로 제공됩니다. 미디어 처리를 위해 FFmpeg와 libwebp가 필요하며, Linux, macOS, Windows(WSL 권장)를 지원합니다. Raspberry Pi 같은 ARM 보드용 순수 Go 빌드 옵션도 제공합니다.

핵심 기능

  • 01HTTP API를 통해 텍스트, 미디어, 스티커, 투표 등 WhatsApp 메시지를 전송합니다.
  • 02단일 서버에서 여러 WhatsApp 계정을 기기별로 관리합니다.
  • 03HMAC-SHA-256 서명과 이벤트 또는 JID 필터링을 적용해 수신 이벤트를 웹훅으로 전달합니다.
  • 04메시지를 한 번 예약하거나 매일, 매주, 매월 반복하도록 예약합니다.
  • 05MCP 엔드포인트를 통해 AI 에이전트에 WhatsApp 작업을 제공합니다.
  • 06Chatwoot와 연동해 대화를 지원팀 받은편지함으로 연결합니다.

활용 사례

  • WhatsApp 계정을 기반으로 챗봇이나 고객 알림 흐름을 구축합니다.
  • REST API 또는 커뮤니티 노드를 통해 WhatsApp을 n8n 같은 자동화 도구에 연결합니다.
  • MCP를 통해 AI 에이전트가 채팅을 읽고 메시지를 보낼 수 있게 합니다.
  • 여러 계정이 필요한 소규모 팀을 위해 셀프 호스팅 WhatsApp 게이트웨이를 운영합니다.

빠른 시작

  1. 1

    최신 릴리스 페이지에서 바이너리를 다운로드합니다

  2. 2

    REST API와 MCP 서버를 시작합니다

    ./whatsapp rest

사용 전 알아둘 점

  • 웹 대시보드는 시작 시 별도의 저장소에서 다운로드되므로, 에어갭 환경에서는 추가 설정이 필요합니다.
  • 여러 메이저 버전에서 프로그램 실행 및 구성 방식이 크게 변경되어 이전 가이드가 작동하지 않을 수 있습니다.

토픽

자주 묻는 질문

go-whatsapp-web-multidevice은(는) 무엇인가요?
GoWA는 여러 계정, 웹훅, MCP, Chatwoot 연동을 지원하는 Go 기반 셀프 호스팅 WhatsApp REST API입니다. GoWA는 WhatsApp Web의 멀티 디바이스 프로토콜을 HTTP REST API로 감싸, 개발자가 일반적인 HTTP 호출로 메시지를 보내고 그룹을 관리하며 WhatsApp 계정에서 이벤트를 받을 수 있게 합니다. 단일 서버에서 여러 WhatsApp 계정을 동시에 연결하고 관리할 수 있으며, X-Device-Id 헤더나 device_id 매개변수로 기기별 엔드포인트를 선택합니다.
go-whatsapp-web-multidevice은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
go-whatsapp-web-multidevice은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
go-whatsapp-web-multidevice은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. go-whatsapp-web-multidevice의 마지막 커밋은 2026년 10월 21일입니다.
go-whatsapp-web-multidevice은(는) 어디에 사용할 수 있나요?
WhatsApp 계정을 기반으로 챗봇이나 고객 알림 흐름을 구축합니다. REST API 또는 커뮤니티 노드를 통해 WhatsApp을 n8n 같은 자동화 도구에 연결합니다. MCP를 통해 AI 에이전트가 채팅을 읽고 메시지를 보낼 수 있게 합니다. 여러 계정이 필요한 소규모 팀을 위해 셀프 호스팅 WhatsApp 게이트웨이를 운영합니다.
go-whatsapp-web-multidevice는 어떻게 설치하나요?
최신 릴리스 페이지에서 바이너리를 다운로드합니다 REST API와 MCP 서버를 시작합니다: ./whatsapp rest
go-whatsapp-web-multidevice은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aldinokemal/go-whatsapp-web-multidevice

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트