사용자 가이드

채널 설정
개인 설정
팀 메신저
고객 메신저
고객 연락처
AI
워크플로우
분석
마케팅
외부서비스 연동
앱스토어
미트
구독 및 결제
도큐먼트
thumbnail

주변 매장 조회

고객이 입력한 주소를 기반으로 가장 가까운 매장을 찾아주는 함수를 제공합니다.

지원 기능

앱스토어의 주변 매장 조회 앱을 설치하면, 고객 주소와 등록된 매장 주소를 비교해 가장 가까운 매장을 반환하는 함수를 사용할 수 있습니다.

연동 방법

  1. [채널 설정] > [연동] > [앱스토어]에서 주변 매장 조회 앱을 찾아 [설치하기]를 클릭합니다.

  2. [설정] 탭의 매장 관리 화면에서 매장 이름과 주소를 등록합니다.

    ※ 매장 이름은 중복으로 등록할 수 없습니다.

매장 데이터는 채널 단위로 완전히 분리되어, 다른 채널의 매장 정보는 조회되지 않습니다.

태스크에서 함수 사용하기

태스크를 통해 고객 주소를 입력받고, 가장 가까운 매장을 자동으로 안내할 수 있습니다.

  • 주변 매장 조회 앱을 설치 후 [AI] - [설정] - [태스크] - [태스크 만들기] - [새로 만들기]를 통해 제공되는 함수를 설정하여 태스크를 만들 수 있습니다. (→ 태스크 알아보기)

제공되는 함수

  • store.findNearestStore

고객 주소 기준으로 가장 가까운 매장 이름과 주소를 반환합니다.

  1. 입력

필드

타입

설명

userAddress

string

기준이 되는 고객 위치 주소 (도로명/지번). 예: "강남구 테헤란로 231"

  1. 출력

필드

타입

설명

ok

boolean

성공 여부. false면 message에 사유

userSubmittedAddress

string

입력한 원본 주소 (ok=true)

userResolvedAddress

string

정규화된 고객 주소 (ok=true)

storeName

string

가장 가까운 매장 이름 (ok=true)

storeRegisteredAddress

string

등록된 매장 주소 (ok=true)

storeResolvedAddress

string

정규화된 매장 주소 (ok=true)

message

string

실패 사유 (ok=false)

  • address.searchAddress

입력한 주소를 네이버 지도로 조회해 도로명주소, 지번주소, 우편번호를 반환합니다.

  1. 입력

필드

타입

설명

query

string

조회할 주소 문자열. 일치도 1순위 결과만 반환. 예: "중구 세종대로 110"

  1. 출력

필드

타입

설명

found

boolean

조회 성공 여부. false면 나머지는 빈값

roadAddress

string

도로명주소 (없으면 "")

jibunAddress

string

지번주소 (없으면 "")

zipCode

string

우편번호 5자리 (없으면 "")

lat

number

위도(WGS84), found=false면 0

lng

number

경도(WGS84), found=false면 0