Webhook 실시간 수신 플러그인 > 플러그인

• 목록

압축을 해제한 후 코어의 plugin 폴더 안에 넣고 사용합니다. 플러그인을 활성화한 뒤 관리자 메뉴의 플러그인 > 웹훅에서 스트림 정보를 확인할 수 있습니다.

주요 기능

• 코어 내부에서 발생한 시스템 이벤트를 실시간으로 구독할 수 있는 SSE 스트림을 제공합니다.
• 별도 DB 테이블 없이 바로 사용할 수 있는 경량 플러그인입니다.
• 내부 보안 토큰 검증을 거친 요청만 스트림에 접속할 수 있습니다.

스트림 주소

GET /api/v1/plugins/ep_webhook/stream
GET /api/webhook/stream

요청 헤더에 아래 값을 함께 보내야 합니다.

X-NARU-Internal-Token: 내부보안토큰

사용 방법

• 플러그인을 설치하고 활성화합니다.
• 이벤트를 수신할 외부 서비스 또는 내부 클라이언트에서 SSE 방식으로 스트림에 접속합니다.
• 서버에서 시스템 이벤트가 발생하면 event, payload, sent_at 형식으로 실시간 전달됩니다.
• 장시간 연결에서는 keep-alive 신호가 함께 전달됩니다.

활용 예시

• 외부 자동화 서비스와 실시간 연동
• 알림, 로그 수집, 이벤트 모니터링 대시보드 연동
• 코어 내부 이벤트를 다른 시스템으로 중계하는 브리지 구성

연동 시 내부 보안 토큰이 올바르지 않으면 인증 실패가 발생하므로 토큰 값을 먼저 확인해 주세요.