무료 WhatsApp 개발 터널(ngrok 없이) 및 Node.js 기반의 셀프 힐링 루프를 구축한 방법

안녕하세요 여러분,

저는 Pixel Office(WhatsApp에서 실행되는 멀티 에이전트 어시스턴트)라는 Node.js 프로젝트를 작업해 왔습니다. 이를 구축하는 동안 저희 개발 팀은 로컬 테스트 및 배포 과정에서 몇 가지 병목 현상에 직면했고, 이를 해결하기 위해 몇 가지 커스텀 유틸리티를 직접 만들었습니다.

이 도구들이 매우 유용하다는 것이 증명되어, 오늘 이들을 하나로 묶어 저장소(repository)를 오픈 소스로 공개하기로 결정했습니다. 저희가 통합한 세 가지 개발 도구에 대한 상세 내용은 다음과 같습니다:

1. 로컬 웹훅 터널 (No ngrok)

WhatsApp 웹훅(webhook)을 로컬에서 테스트하려면 보통 ngrok를 설정해야 하는데, ngrok의 무료 티어는 점점 더 제한적이 되고 있으며 방화벽 규칙을 구성해야 하는 번거로움도 있습니다.

이를 우회하기 위해, 저희는 Express 백엔드에 간단한 Socket.io 프록시(proxy)를 구축했습니다. Meta가 개발자의 전화기를 대상으로 웹훅을 보내면, 서버가 이를 가로채서 JSON 페이로드(payload)를 WebSocket을 통해 로컬 CLI 클라이언트로 직접 스트리밍합니다.

로컬에서 다음과 같이 실행하기만 하면 됩니다:

bash
node bin/tunnel-cli.js --port 3000 --key YOUR_API_KEY