App Link(Universal Link) 사용하기
App Link(Universal Link)를 사용하여 NAVER WORKS 앱을 실행하고 주요 서비스 기능을 사용할 수 있다.
기본 형식
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: 드라이브 • board: 게시판 • home: 홈 • mail: 메일 • more: 더보기/홈 |
| path | 서비스 내 상세 기능을 정의한다. |
| version={link_version} | 사용하는 App Link(Universal Link)의 버전을 정의 • 18: App Version 3.0을 지원한다. • 26: App Version 3.5를 지원한다.. • 28: App Version 3.7을 지원한다. |
| {parametar1=values1} | App Link(Universal Link)를 통해 수행하려는 기능에 전달해야 할 정보를 정의한다. |
App Link(Universal Link) 지원 명령
NAVER WORKS 앱 실행
NAVER WORKS 모바일 앱을 실행한다.
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/default?version={link_verion} | NAVER WORKS 앱을 실행한다. |
NAVER WORKS 앱을 실행해 특정 페이지 열기
NAVER WORKS 모바일 앱을 실행하여 특정 서비스 탭을 연다.
| 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/board?version={link_version} | 게시판 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다. |
https://naver.worksmobile.com/home?version={link_version} | 홈(link_version이 28이상) 또는 게시판(link_version이 28미만) 탭이 보이는 상태로 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} | 홈(앱 버전 v3.7 이상) 또는 더보기(앱 버전 v3.6) 탭이 보이는 상태로 NAVER WORKS 모바일 앱이 실행된다. |
메시지 전송
App Link를 연 환경에 따라 모바일 앱 혹은 PC 웹이 실행되어, 입력한 메시지를 지정된 대상이 포함된 메시지방에 전달한다.
대상이 1명이면 1:1 메시지방, 여러 명이면 1:N 메시지방이 생성된다. 1:1 메시지방은 기존 메시지방이 있는 경우 해당 메시지방에 메시지를 전달하며, 1:N 메시지방은 AppLink를 실행할 때마다 새로운 메시지방이 생성하여 메시지를 전달한다.
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/message/send?version={link_version}&message={message}&emailList={email_Address_List}&callbackMainYn={Y/N} | 파라미터로 지정된 emailAddress 목록이 포함된 메시지방에 메시지를 전달한다. |
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를 확인 할 수 있습니다.
Example
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/message/send?version={link_version}&message={message}&emailList={emailAddressList} | {emailAddressList}로 구성된 메시지방에 {message}를 전송한다. |
일정 생성
NAVER WORKS 모바일 앱이 입력한 일정을 생성한다.
| 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}를 포함해서 생성한다. |
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 | 메모 |
Example
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/calendar/event/write?version={link_version}&scheduletype={schedule_type}&content={contents}&startdate={start_date}&invitees={invitees} | {start_date}에 {invitees}가 참석하는 {contents} 제목의 {schedule_type} 일정을 생성한다. |
메일 쓰기
NAVER WORKS 모바일 앱이 입력한 정보로 메일 작성화면을 보여준다.
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/mail/write?version={link_version}&to={to_mail_addresses}&cc={cc_mail_addresses}&subject={subject}&body={body} | {subject}제목과 {body}의 본문을 {to_mail_addresses}수신자와 {cc_mail_addresses}참조수신자에게 보낼수 있는 메일 쓰기 화면에 진입한다. |
Parameter
| 파라미터 | 필수여부 | 설 명 | 비고 |
|---|---|---|---|
| version | Y | App Link(Universal Link) Version | |
| to | N | 수신자 이메일 주소 | 여러 명일 경우 ; 로 구분 |
| cc | N | 참조 수신자 이메일 주소 | 여러 명일 경우 ; 로 구분 |
| subject | N | 메일 제목 | 인코딩된 스트링 |
| body | N | 메일 본문 | 인코딩된 스트링 |
Example
| App Link(Universal Link) | Description |
|---|---|
https://naver.worksmobile.com/mail/write?version=8&to=user1@worksmobile.com;user2@worksmobile.com&cc=user3@worksmobile.com&subject=testsubject&body=testbody | testsubject 제목과 testbody의 본문을 user1@worksmobile.com, user2@worksmobile.com 수신자와 user3@worksmobile.com의 참조 수신자에게 보낼 수 있는 메일 쓰기 화면에 진입한다. |