배송 조회

지원 기능

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

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

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

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

사용 조건

배송 조회 앱은 ALF가 고객의 질문 의도를 파악하고 필요한 정보를 추출한 뒤, 태스크 함수(delivery.trackDelivery 등)를 호출해 결과를 안내하는 구조입니다.

따라서 배송 조회 앱을 사용하려면 ALF 사용이 필요합니다.
일반 워크플로우(서포트봇) 설정만으로는 배송 조회 앱의 태스크 함수를 호출할 수 없어, 워크플로우만으로는 배송 조회 기능을 사용할 수 없습니다.

지원 택배사 확인

지원되는 택배사는 배송 조회 앱에서 제공하는 택배사 목록 기준으로 확인해야 하며, 목록에 없는 택배사는 조회할 수 없습니다.

지원 택배사 목록/코드는 delivery.getCarriers로 조회할 수 있습니다. (예: searchText로 택배사 이름 일부를 검색)
특정 택배사가 목록에서 조회되지 않으면 해당 택배사는 배송 조회를 지원하지 않습니다. 예를 들어 SF Express, Yun Express가 목록에 없으면 배송 조회 정보를 가져올 수 없습니다.

제공되는 함수

`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[]	택배사 목록