배송 조회

지원 기능

태스크를 통해 택배사 이름과 운송장 번호를 수집하고 자동으로 안내할 수 있어요.

배송 조회 앱에서 제공되는 태스크 함수를 활용하면, ALF가 고객 응대 시 고객이 배송 조회 관련 문의를 할 때 ALF가 택배사 이름과 운송장 번호를 조회한 후 결과를 고객에게 직접 안내할 수 있어요.

상담원이 매번 택배사 사이트를 확인하거나 고객에게 일일이 안내하지 않아도 되어, 반복되는 배송 문의를 줄일 수 있습니다.

[AI] - [설정] - [태스크] - [태스크 만들기] - [새로 만들기]를 통해 제공되는 함수를 설정하여 태스크를 만들 수 있습니다. (→ 태스크 알아보기)

제공되는 함수

`delivery.trackDelivery`

택배사와 운송장 번호로 배송 상태 및 이동 내역을 조회합니다.

입력

필드	타입	필수 여부	설명
`carrierId`	string	조건부	택배사 코드 ex)`kr.cjlogistics`
`carrierName`	string	조건부	택배사 이름 ex)`CJ대한통운`, `한진택배`
`trackingNumber`	string	필수	운송장번호

필드

타입

필수 여부

설명

carrierId

string

조건부

택배사 코드

ex)kr.cjlogistics

carrierName

string

조건부

택배사 이름

ex)CJ대한통운, 한진택배

trackingNumber

string

필수

운송장번호

carrierName과 carrierId 중 하나는 반드시 입력해야 합니다. carrierName을 입력하면 내부적으로 택배사 코드가 자동 매핑되므로, 별도로 택배사 코드를 조회하지 않아도 됩니다. 만약 둘 다 입력한 경우 carrierId가 우선 적용됩니다.

출력

필드	타입	설명
`found`	boolean	배송 조회 결과 존재 여부
`carrierId`	string \| null	조회에 사용된 택배사 코드
`carrierName`	string \| null	조회에 사용된 택배사 이름`carrierName`으로 자동 검색한 경우에만 값이 설정됩니다.
`lastEvent`	DeliveryEvent \| null	가장 최근 배송 이벤트 이벤트가 없으면 `null`이 반환됩니다.
`events`	DeliveryEvent[]	최근 배송 이벤트 목록 최대 20개까지 반환됩니다.
`error`	string \| null	처리 가능한 오류 메시지 `found`가 `true`이면 `null`이 반환됩니다.

DeliveryEvent 필드

배송 이벤트(lastEvent, events) 각각은 아래 필드로 구성됩니다. 택배사에서 제공하지 않는 경우 null로 내려올 수 있습니다.

필드	타입	설명
`time`	string \| null	이벤트 발생 시각
`status.code`	string	배송 상태 코드
`status.name`	string \| null	배송 상태 이름
`description`	string \| null	이벤트 상세 설명
`location.name`	string \| null	이벤트 발생 위치

`delivery.getCarriers`

지원되는 택배사 목록과 택배사 코드를 조회합니다. 검색어나 국가 코드로 필터링할 수 있습니다.

대부분 delivery.trackDelivery에 택배사 이름을 입력하면 자동으로 매핑됩니다. 이 함수는 특정 택배사의 정확한 코드를 확인하고 싶을 때 활용할 수 있습니다.

입력

모든 필드는 선택 사항입니다. 아무것도 입력하지 않으면 전체 택배사 목록이 반환됩니다.

필드	타입	기본값	설명
`searchText`	string	없음	택배사 검색어 ex)`CJ`, `한진`
`countryCode`	string	없음	국가 코드로 필터링 ex)`KR`
`first`	integer	`20`	조회 개수 최소 1, 최대 100
`after`	string	없음	다음 페이지 조회를 위한 커서 값

출력

필드	타입	설명
`pageInfo.hasNextPage`	boolean	다음 페이지 존재 여부
`pageInfo.endCursor`	string \| null	다음 페이지 요청 시 `after`에 사용할 커서 값
`carriers`	Carrier[]	택배사 목록