카테고리
커넥트
다양한 외부 서비스와 연동하여 정보를 통합할 수 있는 기능
잔디 커넥트가 무엇인지 궁금합니다.
* 잔디커넥트(JANDI Connect)는 타 서비스를 잔디에 연결하여 메시지 알림을 받는 기능입니다. - 업무에 필요한 서비스들의 메시지 알림을 잔디로 모아 받으면 업무 커뮤니케이션 툴을 일원화할 수 있습니다. - Google 캘린더, Trello, JIRA, GitHub, Bitbucket 등의 서비스와 원하는 데이터를 잔디로 받아볼 수 있는 RSS, 인커밍 웹훅(Incoming Webhook), 아웃고잉 웹훅(Outgoing Webhook)을 연동할 수 있습니다. ✅잔디 커넥트 실행 방법 1. 토픽 상단 또는 메뉴바에서 플러그 모양의 [잔디 커넥트] 아이콘을 클릭합니다. 2. 원하는 서비스를 연동 및 수정해주세요. ✅잔디 커넥트 자세히 알아보기 - 잔디 커넥트의 모든 것 블로그 보러가기 👉 - 잔디 커넥트 연동 사례 보러가기 👉 - 잔디 커넥트 실습 영상 보기👇 추가로 연동을 원하는 서비스가 있다면 잔디 커넥트 서비스 요청 설문조사에서 원하는 서비스를 선택해주세요!잔디 커넥트 생성 권한을 제한하고 싶습니다.
* 팀 관리자는 'JANDI 커넥트' 생성 권한을 제한할 수 있습니다. 1. PC/Web 잔디 대화창 상단 [≡] - [관리자 메뉴] - [부가 기능 설정] 탭을 클릭해 이동합니다 2. [부가 기능 설정] 탭에서 [JANDI 커넥트 설정 권한]을 [관리자만]으로 선택해주세요. - 모든 멤버가 커넥트를 생성할 수 있도록 하거나 - 관리자만 커넥트를 생성할 수 있도록 설정할 수 있습니다. * 이미 생성된 커넥트는 권한을 변경하여도 삭제되지 않습니다. PDF 가이드 - 잔디가 콕콕 찝어주는 잔디 사용 가이잔디 커넥트 인커밍 웹훅(Incoming Webhook)으로 외부 데이터를 잔디로 수신하고 싶습니다.
Webhook이란? 웹훅(Webhook)이란 잔디에 잔디가 정한 포맷에 일치하는 데이터를 수신하여 지정된 대화에 메시지 형태로 전송해주는 기능을 말합니다. 현재 잔디 커넥트에서 지원하지 않고 있는 서비스라도 해당 서비스에서 웹훅 발신(Outgoing Webhook)을 지원하는 경우, 잔디와 연동하여 변동 사항에 대해 메시지를 수신할 수 있습니다. * Tip : 개발자 또는 IT 부서 직원의 도움을 받는다면 좀 더 쉽게 설정하실 수 있습니다. STEP 1 잔디에서 생성된 Webhook URL 로 메시지로 수신하고 싶은 정보(HTTP POST request)를 전송해주시면 됩니다. request에는 반드시 Accept와 Content-Type을 다음과 같이 지정해줘야 합니다. - Accept: application/vnd.tosslab.jandi-v2+json - Content-Type: application/json 참고 : 잔디 웹훅은 restful API로 동작하기 때문에 htt잔디 커넥트 아웃고잉 웹훅(Outgoing Webhook)으로 서비스를 연동하고 싶습니다.
Webhook 발신 (Outgoing Webhook)은 특정 키워드를 포함한 메시지가 잔디에서 발생했을 때, 외부 서버로 이 정보를 전달할 수 있는 기능입니다. 따라서 외부 웹 서버 개발을 통해 사내 서비스 연동, 챗봇 등으로 다양하게 활용할 수 있습니다. * Tip : 개발자 또는 IT 부서 직원의 도움을 받는다면 좀 더 쉽게 설정하실 수 있습니다. - 잔디에서 발송되는 Webhook URL 로 전달하고 싶은 정보(HTTP POST request)를 전송해주시면 됩니다. 이 웹훅을 작동하는 시작 키워드를 정해주세요. - 연동이 완료되면, 아래 이미지와 같이 /(슬래시) 키워드로 외부 서비스와 연동된 웹훅을 작동 시키고 정보를 잔디로 불러 들여올 수 있습니다. < 더 자세한 Outgoing Webhook 설명서 읽어보기 > < Outgoing Webhook 연동 사례 보러가기 >전체 멤버에게 Team Incoming Webhook을 발송하고 싶습니다.
1. Team Incoming Webhook 개요 외부 데이터를 JANDI에서 수신하고 싶을 때 사용되는 기능이 Incoming Webhook 입니다. 하지만 외부 데이터를 전송하고 싶은 경우 개인별로 다음과 같은 절차를 거쳐야 합니다. 개인별로 Incoming Webhook을 생성하고, 생성된 URL을 담당자에게 전달합니다. 담당자는 URL과 개인 정보를 매칭하여 저장하고, 입·퇴사 또는 인사 이동이 있을 경우 기존에 이 멤버들이 만든 Incoming Webhook의 각 등록 및 삭제를 진행합니다. 위의 예시처럼 개인별로 Incoming Webhook을 생성시 팀 차원에서 관리가 어렵습니다. 이를 해결하기 위해 Team Incoming Webhook이 개발됐습니다. 관리자 혹은 소유자가 Team Incoming Webhook을 한 번만 생성해 생성된 URL에 메시지와 함께 개인 식별자 (잔디의 가입된 계정 e-mail)를 전송하면 개인별 메시지 수신이 가능해집니다. 이를 통해 잔디전체 멤버들이 Team Outgoing Webhook을 사용할 수 있도록 하고 싶습니다.
Outgoing Webhook이란 특정 키워드를 포함한 메시지가 잔디에서 발생했을 때 외부 서버로 이 정보를 전달할 수 있는 기능입니다. Team Outgoing Webhook은 팀내 관리자가 연동했을 경우 구성원들이 JANDI(나와의 대화)에서 간편하게 정보를 확인할 수 있는 기능입니다. [Team Outgoing Webhook 개요] 특정 키워드를 포함한 메시지가 잔디에서 발생했을 때 외부 서비스로 이 정보를 전달할 수 있는 기능이 Outgoing Webhook입니다. Team Outgoing Webhook을 이용한다면 웹훅 수정, 삭제 등의 관리를 관리자가 대표하기 때문에 구성원들이 직접 수정할 필요가 없고 관리자가 한 번 설치하면 팀 구성원 모두가 동일한 기능을 이용할 수 있습니다. 잔디에서는 /command parameter 형태로 아웃고잉 웹훅을 이용하며, 웹훅에 대한 설명과 parameter 예시를 입력하여 구성원의 사용을 보조합니다. 웹훅 메시지 작성 및 알림 수신