커스텀 트리거 연동 문서

최근 업데이트 2026. 10. 03.

호출 방법은 Open API 문서의 호출 방법 설명을 참고하십시오.

1. 커스텀 트리거 작업 생성

커스텀 트리거의 트리거 규칙에서 트리거 시나리오를 생성하고 고유한 시나리오 ID를 설정한 다음, 해당 트리거 작업의 트리거 주체 ID 타입을 선택합니다.

Tip: 여기서 트리거 규칙을 충족하는 시나리오 ID와 트리거 주체 ID가 서버 측 설정과 일치해야 트리거에 성공합니다.

그림의 번호: 1은 시나리오 새로 만들기로, 트리거 시나리오 드롭다운 하단에서 + 시나리오를 클릭합니다. 2는 시나리오 새로 만들기 팝업의 시나리오 ID, 3은 주체 ID입니다.

2. 트리거 API 호출

2.1 API URL

open/hermes/custom/trigger?token=xxx&projectId=11

2.2 요청 방식

POST

2.3 Content-Type

application/json

2.4 요청 Query 파라미터

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
eventuuid	xxx	String	예	이벤트 고유 id
projectId	11	int	예	프로젝트 id
sceneId		String	예	시나리오 id
entityId		String	예	시나리오의 주체 id 타입 값: accountId/distinctId
eventTime		long	예	이벤트 시간
eventTimezone		double	권장(생략 가능)	이벤트 시간-시간대, 기본값은 서버 시간대

2.5 성공 응답 예시

{
    "return_code": 0,
    "return_message": "success"
}

파라미터 이름	예시 값	파라미터 타입	파라미터 설명
return_code	0	Integer	반환 코드
return_message	success	String	반환 정보

2.6 오류 응답 예시

{
    "return_code": -1008,
    "return_message": "파라미터 오류"
}

2.7 오류 코드 설명

오류 코드	오류 설명
-1008	파라미터 오류(hermes.open.service.error.eventtime.not_valid)
-1006	token 인증 실패(error.auth.authority_forbidden.token)
-1005	요청 과다/API 속도 제한(error.op.too_many_open_api_request)
-1023	시나리오/작업이 존재하지 않거나 이미 삭제됨(error.op.not_existed_with_name)
-1011	해당 작업의 상태가 진행 중이 아님(hermes.open.service.error.task.status_not_working)
-1009	유저가 존재하지 않음(hermes.open.service.error.user_id.not_exit)
-1108	이벤트 중복(hermes.open.service.error.task.event_id.repeat)
-1004	시스템 오류(hermes.service.error.system.common)