메인 콘텐츠로 건너뛰기

​
연동이란?

**연동(Integration)**은 LexQ를 외부 서비스에 연결합니다. 규칙의 액션이 실행될 때, LexQ가 쿠폰 시스템, 포인트 플랫폼, 알림 서비스, 또는 웹훅 엔드포인트를 호출할 수 있습니다. 연동은 한 번 설정한 후 규칙 액션에서 ID로 참조합니다.

​
연동 유형

유형설명사용 사례
WEBHOOKHTTP 엔드포인트 호출주문 처리, 커스텀 로직
COUPON외부 서비스를 통해 쿠폰 발행웰컴 쿠폰, 시즌 프로모션
POINT포인트 적립 또는 차감로열티 프로그램, 캐시백
NOTIFICATIONSMS, 이메일, 푸시 발송주문 확인, 알림
CRM사용자 데이터 또는 태그 동기화고객 세분화
MESSENGER채팅 플랫폼으로 메시지 발송고객 지원 자동화

​
연동 생성

​
콘솔

관리 → 연동 → 연동 생성으로 이동, 유형 선택 후 설정을 입력합니다.

​
CLI

lexq integrations save --json '{
  "type": "WEBHOOK",
  "name": "주문 처리 웹훅",
  "baseUrl": "https://api.example.com/webhooks/orders",
  "isActive": true
}'

​
필수 설정 확인

각 유형마다 필요한 설정 필드가 다릅니다: 
lexq integrations config-spec --type WEBHOOK
lexq integrations config-spec --type COUPON

​
규칙에서 연동 사용

규칙 액션 파라미터에서 연동 ID를 참조합니다: 
{
  "type": "POINT",
  "parameters": {
    "refVar": "payment_amount",
    "method": "PERCENTAGE",
    "rate": 1,
    "integrationId": "<포인트-연동-id>"
  }
}

{
  "type": "COUPON_ISSUE",
  "parameters": {
    "couponId": "WELCOME_10",
    "integrationId": "<쿠폰-연동-id>"
  }
}

​
연동 관리

lexq integrations list
lexq integrations get --id <integrationId>
lexq integrations save --json '{...}'
lexq integrations delete --id <integrationId>

​
장애 처리

실행 중 연동 호출이 실패하면 (네트워크 타임아웃, 5xx 응답 등) 장애 로그에 기록됩니다. 재시도, 건너뛰기, 해결 처리가 가능합니다: 
lexq logs list --status PENDING
lexq logs action --id <logId> --action RETRY
배치 시뮬레이션에서는 연동 호출이 항상 모킹됩니다. 드라이런에서는 mockExternalCalls 파라미터(기본값: true)로 제어합니다. 끄면 실제 외부 호출을 시도하며, 실패 시 장애 로그에 기록됩니다.

​
다음 단계

정책 규칙

규칙 액션에서 연동을 사용하는 방법을 알아보세요.

문제 해결

일반적인 연동 문제와 해결 방법.