Webhook과 Polling 하이브리드 구조를 통한 실시간 응답성 및 데이터 정합성 확보

Context

기존 Polling 기반 아키텍처의 높은 API 호출 낭비와 실시간성 부족 문제 분석. 2,880회 호출 중 2,879회가 무효 응답인 리소스 낭비 상황에서 Conversational Agent의 응답 지연을 해결해야 하는 과제 직면.

Technical Solution

• message.created 트리거 기반 Webhook 도입을 통한 이벤트 기반 실시간 푸시 구조 설계
• HMAC-SHA256 기반 X-Nylas-Signature 검증으로 페이로드 위조 방지 및 보안성 강화
• 10초 이내 200 OK 응답 및 비동기 처리(Ack first, process async)를 통한 타임아웃 방지
• Application-level 구독 모델 채택으로 단일 Webhook 엔드포인트에서 다수 Agent 계정 통합 관리
• Webhook의 At-least-once 전달 특성에 따른 중복 수신 방지용 Message ID 기반 Dedup 로직 구현
• Polling을 보조 수단으로 활용하는 Reconciler 패턴 도입으로 유실된 데이터의 최종 정합성 보장