본문으로 건너뛰기

Zid Assistant

개요​

Zid Assistant는 Zid 스토어를 위한 WhatsApp, Instagram, 웹 채팅 데스크입니다. 상품, 주문, 이탈한 장바구니, 고객 정보가 Zid에서 자동으로 들어오고, 어시스턴트는 MonoChat 자체 AI 모델로 고객의 언어로 24시간 답합니다. AI 키를 입력할 필요가 없습니다.

배송, 반품, 직접 등록한 질문은 승인한 정책과 질문으로만 답합니다. 사람이 필요하면 어시스턴트가 대화를 팀에 넘기거나 메시지를 남겨 둡니다.

주요 기능​

  • 채팅 속 상품. 고객이 상품, 사이즈, 색상을 물으면 사진, 가격, Buy(구매)와 Details(상세) 버튼이 있는 상품 카드를 받습니다. Buy를 누르면 Zid 스토어의 상품 페이지가 열립니다.
  • "내 주문 어디 있나요?"에 답변. 어시스턴트가 주문 번호나 고객 전화번호로 주문을 찾아 상태, 배송사, Zid에 있는 추적 링크를 알려 줍니다.
  • 주문 알림. 주문이 발송, 배송 완료, 취소될 때 변경마다 한 번씩 고객에게 알립니다.
  • 착불 결제 확인. 착불 결제 신규 주문에는 WhatsApp으로 Confirm order(주문 확인)와 Cancel order(주문 취소) 버튼이 전송됩니다. 팀은 답변을 보고 Zid에서 주문을 변경하며, 아무도 답하지 않으면 팀에 콜백 요청이 생성됩니다. Zid에서 이미 확인된 주문은 다시 묻지 않습니다.
  • 장바구니 이탈. Zid 결제 단계에서 남겨진 장바구니에는 장바구니로 돌아가는 링크와 함께 최대 세 번 알림이 전송됩니다.
  • 재입고 알림, 반품, 캠페인은 Shop Assistant와 같은 방식으로 작동합니다.

Zid 연결​

Zid는 스토어가 승인한 비공개 앱을 통해 앱에 스토어를 엽니다. 이 앱의 토큰은 Zid가 비공개 앱용으로 직접 제공하는 도구인 Zid Bridge에서 받으므로 별도의 서버가 필요 없습니다.

  1. Zid Partner Dashboard(partners.zid.sa)에서 Apps › All Apps › Create Application을 열고 스토어용 비공개 앱을 MonoChat이라는 이름으로 만듭니다. 주문, 상품, 고객, 이탈한 장바구니, 스토어 정보에 대한 읽기 권한을 부여합니다.
  2. Zid Bridge(bridge.zid.dev)에 가입하고 앱의 client ID와 client secret(앱 General settings의 API keys에 있음)으로 앱을 등록한 뒤, Zid Bridge가 알려 주는 redirect URL과 callback URL을 앱 설정에 입력합니다.
  3. 스토어에서 앱을 활성화하고 권한을 승인합니다. Zid가 Direct Integration (APIs) 애드온을 요구하면 스토어가 먼저 구독합니다. 그러면 Zid Bridge가 토큰을 한 번만 보여 주므로 Raw JSON을 복사합니다.
  4. MonoChat에서 Shop desk를 열고 Shop connection(스토어 연결)으로 이동한 뒤 Your web shop runs on(웹 스토어 플랫폼)에서 Zid를 선택합니다.
  5. Client ID, Client secret, Redirect URL(Zid Bridge에서 받은 리디렉션 URL)을 입력하고 Raw JSON을 Tokens from Zid Bridge(Zid Bridge 토큰)에 붙여 넣습니다.
  6. Test connection(연결 테스트)을 클릭한 다음 Sync now(지금 동기화)를 클릭합니다.

client secret과 토큰은 서버에 보관되며 마스킹되어 표시됩니다. Zid는 앱이 일정에 따라 토큰을 갱신하도록 요구하므로, 앱이 10개월마다 직접 토큰을 갱신합니다. 이를 위해 client secret과 리디렉션 URL이 필요합니다. Zid가 토큰을 더 이상 받아들이지 않으면(앱이 비활성화되었거나 권한이 바뀐 경우) 연결 화면과 동기화에 재연결 오류가 표시됩니다. Zid Bridge에서 앱을 다시 활성화하고 새 토큰을 붙여 넣으세요. Zid Bridge는 앱의 client ID와 client secret을 보관하며 토큰은 보관하지 않습니다.

Zid에서 가져오는 정보​

데이터주기앱이 보관하는 내용
주문10분마다(**Sync every (minutes)**에서 조정 가능)번호, 상태, 품목, 합계, 결제 수단, 배송사, 운송장 번호, 추적 링크
이탈한 장바구니10분마다고객, 전화번호, 품목, 합계, 장바구니로 돌아가는 링크
상품매시간, 그리고 Sync now를 누를 때마다이름, 설명, 카테고리, 브랜드, 사진, 링크, 가격·할인가·재고가 포함된 옵션
고객하루 한 번이름, 전화번호, 이메일

첫 동기화에서는 최근 30일의 주문과, 알림이 아직 닿을 수 있는 이탈한 장바구니(기본 7일)를 읽습니다. 스토어 통화가 비어 있으면 첫 주문에서 채워집니다. 동기화는 분당 60회라는 Zid의 요청 한도 안에서 이루어집니다.

노트
  • 앱은 Zid에서 읽기만 하고 아무것도 기록하지 않습니다. 취소나 상태 변경은 팀이 Zid에서 합니다.
  • Zid의 변경 사항은 즉시가 아니라 다음 동기화 때 MonoChat에 반영됩니다. 앱은 아직 Zid의 웹훅을 받지 않습니다.
  • 설정 변경, Zid 연결 테스트, 샘플 데이터 불러오기와 삭제는 소유자 또는 manager라는 이름의 사용자 지정 역할을 가진 사용자가 합니다. 모든 상담원은 데스크에서 일하고 동기화를 시작할 수 있습니다.