App Link(Universal Link) 사용하기

    App Link(Universal Link)를 사용하여 NAVER WORKS 앱을 실행하고 주요 서비스 기능을 사용할 수 있다.

    1. 기본 형식

    App Link(Universal Link)의 형식은 다음과 같다.

    https://naver.worksmobile.com/{host}/{path..}?version={link_version}?{parameter1=values1}&{parameter2=values2}...

    Host, Path 및 Parameter

    아래 항목을 App Link(Universal Link)에 포함해 전달한다.

    Item Description
    host App Link(Universal Link)를 통해 기능 수행을 하고 싶은 서비스 명칭

    ● default: NAVER WORKS 앱
    ● message: 메시지
    ● calendar: 캘린더
    ● contact: 주소록
    ● drive: 드라이브
    ● home: 게시판
    ● mail: 메일
    ● more: 더보기
    path 서비스 내 상세 기능을 정의한다.
    version={link_version} 사용하는 App Link(Universal Link)의 버전을 정의
    ● 18: App Version 3.0을 지원한다.
    ● 26: App Version 3.5를 지원한다.
    {parametar1=values1} App Link(Universal Link)를 통해 수행하려는 기능에 전달해야 할 정보를 정의한다.

    2. App Link(Universal Link) 지원 명령

    2.1. NAVER WORKS 앱 실행

    NAVER WORKS 모바일 앱을 실행한다.

    run_lw_app

    App Link(Universal Link) Description
    https://naver.worksmobile.com/default?version={link_verion} NAVER WORKS 앱을 실행한다.

    2.2. NAVER WORKS 앱을 실행해 특정 페이지 열기

    NAVER WORKS 모바일 앱을 실행하여 특정 서비스 탭을 연다.

    run_lw_app_with_opening_specific_page

    App Link(Universal Link) Description
    https://naver.worksmobile.com/calendar?version={link_version} 캘린더 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.
    https://naver.worksmobile.com/contact?version={link_version} 주소록 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.
    https://naver.worksmobile.com/drive?version={link_version} 드라이브 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.
    https://naver.worksmobile.com/home?version={link_version} 게시판 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.
    https://naver.worksmobile.com/mail?version={link_version} 메일 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.
    https://naver.worksmobile.com/message?version={link_version} 메시지 탭이 보이는 상태로 NAVER WORKS 모바일 앱 또는 PC 웹이 실행된다.
    https://naver.worksmobile.com/more?version={link_version} 더보기 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다.

    2.3. 메시지 전송

    App Link를 연 환경에 따라 모바일 앱 혹은 PC 웹이 실행되어, 입력한 메시지를 지정된 대상이 포함된 대화방에 전달한다.
    대상이 1명이면 1:1 대화방, 여러 명이면 1:N 대화방이 생성되며, 동일 참석자가 있는 기존 대화방이 있으면 해당 대화방에 메시지를 전달한다.

    send_message

    App Link(Universal Link) Description
    https://naver.worksmobile.com/message/send?version={link_version}&message={message}&emailList={email_Address_List}&callbackMainYn={Y/N} 파라미터로 지정된 emailAddress 목록이 포함된 대화방에 메시지를 전달한다.

    2.3.1 Parameter

    파라미터 필수여부 설명 비고
    version Y App Link(Universal Link) version
    message N 보낼 메시지
    emailList N 메시지를 수신할 User emailAddress 또는 Group emailAddress 목록(;로 구분).
    메시지 전달 대상(User emailAddress, Group emailAddress)을 설정하지 않으면 앱에서 메시지 전달 대상 선택 메뉴를 노출한다.
    worksAtResourceIdList N 메시지를 수신할 외부 대화 상대의 Resource ID 목록(;로 구분)
    channelId N ※ version 26 이상일 때 지원
    메시지를 수신할 메시지방의 channelId.
    channelId를 입력하면 emailList나 worksAtResourceIdList에 값이 있어도 무시된다.
    callbackMainYn N 대화방을 닫을 때 NAVER WORKS 앱 메인 화면으로 돌아가는지 여부
    ● Y: 메인 화면으로 돌아감(기본값)
    ● N: 메인 화면으로 돌아가지 않음    		 Android only

    참고
    대화방 서랍 메뉴에서 '채널 ID'를 선택하면 channelId를 확인 할 수 있습니다.

    2.3.2 Example

    App Link(Universal Link) Description
    https://naver.worksmobile.com/message/send?version={link_version}&message={message}&emailList={emailAddressList} {emailAddressList}로 구성된 대화방에 {message}를 전송한다.

    2.4. 일정 생성

    NAVER WORKS 모바일 앱이 입력한 일정을 생성한다.

    write_schedule

    App Link(Universal Link) Description
    https://naver.worksmobile.com/calendar/event/write?version={link_version}&content={contents}&scheduletype={schedule_type}&startdate={start_date}&invitees={invitees}&memo={memo} {start_date}에 {invitees}가 참석하는 {contents} 제목의 {schedule_type} 일정을 생성한다. {memo}를 포함해서 생성한다.

    2.4.1 Parameter

    파라미터 필수여부 설명 비고
    version Y App Link(Universal Link) Version
    content N 일정 제목
    scheduletype N 일정 타입

    ● 2: 종일 일정
    ● 3: 일반 일정
    startdate N 일정 날짜 및 시간

    ● yyyy-MM-dd: 일정 날짜 타입
    ● yyyy-MM-ddTHH:mm:ss: 일정 날짜 시간 타입
    ● yyyy-MM-ddTHH:mm:ssZ: 일정 날짜 시간 타입    		 일정 날짜 타입의 경우 현재 시간으로부터 한 시간 일정으로 생성됨
    일정 날짜 시간 타입에서 Z가 포함되어 있지 않은 경우 로컬 타임존을 사용
    invitees N 참석자 email 목록(,로 구분)

    ● mailto:attendeetype:name:{name_value}"{attendeetype_value}:{mailto_value}    		 invitee에서 mailto는 필수 항목
    attendeetype: 필수 참석자인지 나타내는 항목
    (0: 필수(default), 1: 옵션)
    memo N 메모  

    2.4.2 Example

    App Link(Universal Link) Description
    https://naver.worksmobile.com/calendar/write?version={link_version}&scheduletype={schedule_type}&content={contents}&startdate={start_date}&invitees={invitees} {start_date}에 {invitees}가 참석하는 {contents} 제목의 {schedule_type} 일정을 생성한다.