Segment

  ## 내용

이 통합을 통해 Botpress 봇을 Segment 애널리틱스와 연결하여 봇의 플로우 내에서 바로 사용자 프로필을 업데이트하고, 노드 보기 및 사용자 지정 이벤트를 추적할 수 있습니다.

## 작동 방식

연동은 액션을 사용하여 Segment 애널리틱스와 상호 작용하는 방식으로 작동합니다. 다음은 액션에 대한 간략한 개요입니다:

1. **사용자 프로필 업데이트**: 이메일 및 이름과 같은 식별 정보로 사용자 프로필을 업데이트합니다.
2. **노드 추적**: 봇 내 특정 노드가 트리거되는 시점을 추적합니다.
3. **이벤트 추적**: 페이로드에 정의된 선택적 속성으로 사용자 지정 이벤트를 추적합니다.

이러한 작업은 쓰기 키를 사용하여 요청을 인증하는 Segment 애널리틱스 API에 의해 지원됩니다.

## 통합 기능

### 액션

- **사용자 프로필 업데이트**
  - Segment 애널리틱스에서 사용자 프로필의 식별 정보를 업데이트합니다.
  - 입력값: 입력: 사용자 ID, 사용자 프로필(선택 사항인 사용자 메타데이터의 JSON 문자열)

- **트랙 노드**
  - 봇 내에서 노드가 트리거된 시점을 추적합니다.
  - 입력값: 입력: 사용자 ID, 노드 ID

- **이벤트 추적**
  - Segment 애널리틱스에서 사용자 지정 이벤트 및 관련 속성을 추적합니다.
  - 입력값: 사용자 ID, 이벤트 이름, 이벤트 페이로드(선택적 이벤트 속성의 JSON 문자열)

### 구성

- 쓰기 키**: 쓰기 키는 Segment 애널리틱스에 대한 요청을 인증하는 데 필요합니다. 소스를 생성한 후 소스 -> API 키 -> 설정 -> 쓰기 키로 이동하여 쓰기 키를 생성할 수 있습니다.

## 설정 지침

#### Segment 애널리틱스 설정

1. Segment  애널리틱스 대시보드에 로그인합니다.
2. Botpress  이벤트를 수신할 새 소스를 생성합니다.
3. 위의 지침에 따라 새 쓰기 키를 생성합니다. 

#### Botpress 설정

1. 오른쪽 상단의 '설치'를 클릭하고 봇을 선택합니다.
2. 팝업 안내에 따라 연동을 구성합니다.
3. Segment  애널리틱스 설정의 Segment 애널리틱스 쓰기 키를 '쓰기 키' 필드에 입력합니다.
4. 4. 연동을 활성화하여 설정을 저장합니다.