## 제품 소개 애프터십 계정과 Botpress 봇을 연결할 수 있는 간단한 통합 기능입니다. 실시간으로 배송을 추적하고 업데이트가 발생하면 봇을 통해 사용자에게 직접 알림을 보내세요. ## 작동 방식 통합을 활성화하면 제공된 'API 키'를 사용하여 애프터십 계정에 Webhook 구독이 구성됩니다. 이 webhook 는 발송물의 추적 상태에 중대한 변경이 있을 때마다 통합에 대한 업데이트를 보냅니다. 발송물 추적` 작업은 발송물 추적을 시작하는 데 사용할 수 있습니다. 이 작업에는 '추적 번호'가 필요하며 Aftership의 API를 사용하여 배송 상태를 가져오고 모니터링하여 추적 데이터 내에 고유한 '대화 ID'를 포함합니다. 그런 다음 이 Id를 사용하여 대화 내에서 '애프터십 이벤트'를 트리거하여 봇이 배송 업데이트에 응답할 수 있도록 합니다. 대화 Id`는 각 대화에 대한 고유 식별자입니다. 이 필드에 ``를 전달하여 ID를 임베드할 수 있습니다. 애프터십 업데이트를 수신할 때 ``애프터십 이벤트 트리거`의 고급 옵션 ``대화 ID` 필드에서 ``를 사용할 수 있습니다. 이렇게 하면 업데이트가 적절한 대화로 전달됩니다. 전체 연동 코드는 심플리 그레이트 봇 Git 페이지에서 확인할 수 있습니다: [애프터십 리포지토리](https://github.com/SimplyGreatBots/aftership) ### 애프터십 설정 #### 전제 조건 추적할 webhook 이벤트를 받으려면 Aftership Pro 요금제 이상이 있어야 합니다. #### API 키 받기 1. 애프터십 관리자 대시보드](https://admin.aftership.com/)로 이동합니다. 2. 개발자` -> `API 키`로 이동합니다. 3. API 키 생성`을 클릭하고 키 이름을 지정한 후 `저장`을 선택합니다. 4. 4. API 키를 복사하여 안전한 곳에 붙여넣습니다. Botpress 설정 시 필요합니다. #### Webhook 및 시크릿 1. 추적 대시보드 -> 알림 -> 웹훅](https://admin.aftership.com/notifications/webhooks#)으로 이동합니다. 2. Webhook 시크릿을 복사하여 안전한 곳에 붙여넣습니다. Botpress 설정 시 이 정보가 필요합니다. 3. ' Webhook 추가'를 클릭합니다. 4. webhook 버전을 기본 "레거시"로 설정합니다. 5. Botpress 애프터십 통합의 Webhook URL을 'Webhook URL' 필드에 붙여넣습니다. 6. webhook 설정을 저장합니다. ### Botpress 설정 1. 애프터십 설정에서 애프터십 API 키를 복사하여 'API 키' 필드에 붙여넣습니다. 2. 애프터십 설정에서 `Webhook 비밀`을 복사하여 `비밀` 필드에 붙여넣습니다.