Mattermost에 Zoom 연결하기#

모든 플랜 에서 사용 가능

Mattermost에 Zoom을 통합하여 회의 조율과 앱 전환으로 인한 마찰과 시간 손실을 줄이세요. 팀원들이 Mattermost 채널에서 직접 즉석 화상 통화를 시작할 수 있도록 쉽게 만들어보세요.

배포#

설정은 Zoom에서 시작하여 Mattermost에서 완료됩니다.

Zoom에서 OAuth 앱 등록하기#

Zoom 시스템 관리자가 Zoom에서 다음 단계를 수행해야 합니다.

Zoom은 OAuth 인증을 지원하며 등록할 수 있는 OAuth Zoom 앱에는 계정 수준 과 사용자 수준 두 가지 유형이 있습니다. 조직의 보안 및 선호도에 따라 두 유형 중 하나를 사용할 수 있습니다.

계정 수준: Mattermost의 개별 사용자는 Mattermost 이메일을 확인하고 Zoom API를 통해 개인 회의 ID를 요청하여 인증됩니다. Mattermost와 Zoom 모두에서 사용자의 이메일 주소가 일치해야 합니다. 각 사용자가 개별적으로 인증하기를 원하는 경우 대신 사용자 수준 Zoom 앱을 만드세요.
사용자 관리: Mattermost의 개별 사용자는 Mattermost 앱이 자신의 Zoom 계정에 접근할 수 있도록 인증해야 합니다. 관리자가 전체 Zoom 조직을 대신하여 접근을 인증하기를 원하는 경우 대신 계정 수준 앱을 만드세요.

Account-Level

Mattermost용 계정 수준 Zoom 앱을 만들기 위해 다음 단계를 완료하세요.

https://marketplace.zoom.us/로 이동하여 관리자로 로그인하세요.
오른쪽 상단에서 개발 을 선택한 다음 앱 빌드 를 선택하세요.
상단에서 개발 을 선택하세요. 마켓플레이스에 게시하는 경우 프로덕션 을 선택하겠지만, 여기서는 그렇게 하지 않을 것입니다.
왼쪽 상단의 편집 아이콘을 클릭하여 앱 이름을 편집할 수 있습니다.
앱 유형으로 관리자 관리 앱 을 선택하세요.
다음으로 클라이언트 ID 와 클라이언트 시크릿 을 찾을 수 있습니다. 플러그인을 사용하도록 Mattermost를 설정할 때 필요하므로 이를 복사하세요.
유효한 OAuth 리디렉션 URL (https://SITEURL/plugins/zoom/oauth2/complete)을 입력하고 허용 목록 추가 아래에 동일한 URL을 추가하세요. SITEURL 은 Mattermost 서버 URL이어야 합니다.
앱에 사용자 범위를 추가하려면 범위 를 선택하고 다음 범위를 추가하세요: meeting:read:meeting:admin, meeting:write:meeting:admin, user:read:user:admin.

User-Managed

Mattermost용 사용자 관리 Zoom 앱을 생성하기 위해 다음 단계를 완료하세요.

https://marketplace.zoom.us/로 이동하여 관리자로 로그인하세요.
오른쪽 상단에서 개발**을 선택한 다음 **앱 빌드 를 선택하세요.
상단에서 개발 을 선택하세요. 마켓플레이스에 게시하는 경우 프로덕션 을 선택하겠지만, 여기서는 그렇게 하지 않을 것입니다.
왼쪽 상단의 편집 아이콘을 클릭하여 앱 이름을 편집할 수 있습니다.
앱 유형으로 사용자 관리 앱 을 선택하세요.
다음으로 클라이언트 ID 와 클라이언트 시크릿 을 찾을 수 있습니다. 플러그인을 사용하도록 Mattermost를 설정할 때 필요하므로 이를 복사하세요.
유효한 OAuth 리디렉션 URL (https://SITEURL/plugins/zoom/oauth2/complete)을 입력하고 허용 목록 추가 아래에 동일한 URL을 추가하세요. SITEURL 은 Mattermost 서버 URL이어야 합니다.
앱에 사용자 범위를 추가하려면 범위 를 선택하고 다음 범위를 추가하세요: meeting:read:meeting, meeting:write:meeting, user:read:user.

웹훅 이벤트 구성#

Zoom 미팅이 종료되면 채널에 공유된 원본 게시물이 자동으로 변경되어 미팅이 종료되었음을 표시하고 지속 시간을 알려줍니다. 이 기능을 활성화하려면 Zoom에서 웹훅 구독을 생성하여 미팅이 종료될 때마다 Mattermost 서버에 알려주도록 하세요. 그러면 Mattermost 서버가 원본 Zoom 메시지를 업데이트합니다.

Zoom에서 앱을 편집하는 동안 왼쪽의 기능 탭 아래에서 액세스 를 선택하세요.
새 이벤트 구독 추가 를 선택하고 Meeting Ended 와 같은 이름을 지정하세요.
유효한 이벤트 알림 엔드포인트 URL https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET 를 입력하세요. SITEURL 을 Mattermost URL로 대체하세요. WEBHOOKSECRET 은 Mattermost 구성 중에 생성됩니다.
웹훅 구성을 저장하려면 저장 을 선택하세요.
다음 섹션에서 사용할 수 있도록 페이지 상단의 시크릿 토큰 값을 복사하세요.

Mattermost 구성#

Mattermost 시스템 관리자는 Mattermost에서 다음 단계를 수행해야 합니다.

제품 내 앱 마켓플레이스에서 Zoom 통합을 설치하세요:

참고

웹훅 시크릿과 암호화 키는 한 번만 표시되므로 복사본을 만드는 것을 권장합니다.

Mattermost에서 제품 메뉴 에서 앱 마켓플레이스 를 선택하세요.
Zoom을 검색하거나 스크롤하여 설치 를 선택하세요.
설치가 완료되면 구성 을 선택하세요. 시스템 콘솔로 이동합니다.
Zoom 구성 페이지에서 Zoom 상호 운용성을 다음과 같이 활성화하고 구성한 다음 저장 을 선택하세요.
자체 호스팅 Zoom 배포의 경우, 자체 호스팅 프라이빗 클라우드나 온프레미스 Zoom 서버를 사용할 때 Zoom 서버의 Zoom URL 과 Zoom API URL 을 입력하세요. 예를 들어 https://YOUR-ZOOM.com 과 https://api.YOUR-ZOOM.com/v2 를 각각 입력하고, YOUR-ZOOM 을 Zoom 서버 URL로 대체하세요. Zoom의 벤더 호스팅 SaaS 서비스를 사용하는 경우 이 필드를 비워두세요.
Mattermost용 계정 수준 Zoom 앱 을 생성한 경우, OAuth by Account Level App 을 true 로 설정하세요. Mattermost용 사용자 수준 Zoom 앱을 생성한 경우 이 값을 false 로 유지하세요.
OAuth를 사용하여 사용자를 Zoom에 연결하세요. Zoom에서 oauth 앱 등록 시 생성된 Client ID 와 Client Secret 을 입력하세요.
At Rest Token Encryption Key 필드 옆의 Regenerate 를 선택하여 AES 암호화 키를 생성하세요. 이 값을 생성하기만 하면 되며, 다른 곳에서는 사용하지 않습니다.
웹훅 이벤트를 구성하는 경우 Webhook Secret 필드 옆의 Regenerate 를 선택하세요. 이는 Mattermost를 가리키는 웹훅 URL에서 사용할 WEBHOOKSECRET 값입니다.
Zoom 웹훅 구성 페이지의 Secret Token 을 플러그인 설정의 Zoom Webhook Secret 에 붙여넣으세요.
변경사항을 저장하려면 Save 를 선택하세요.

활성화#

팀원들에게 Mattermost에 Zoom 계정을 연결 할 수 있다고 알려주세요.

사용#

Mattermost 내에서 Zoom 통화를 시작하려면 유료 Zoom 계정이 필요합니다. Zoom 회의를 처음 생성할 때 계정 연결을 요청받을 수 있습니다. 자격 증명을 사용하여 Zoom 계정을 연결하는 지침을 따르세요.

오른쪽 창에서 Zoom 아이콘을 선택하거나 채널이나 스레드에서 /zoom start 슬래시 명령을 실행하여 통화를 시작하세요. 그러면 모든 채널 구성원이 회의에 참여할 수 있습니다. 회의 호스트는 통화를 시작한 사람입니다.

채널에서 통화 초대를 선택하여 회의에 참여하세요.

/zoom settings 슬래시 명령을 실행하여 회의 호스트로 Zoom 개인 회의 ID 사용 선호도를 설정하세요. 항상 개인 회의 ID를 사용하거나, 항상 새로운 고유 회의 ID를 사용하거나, 통화를 시작할 때마다 선호도를 묻도록 Mattermost를 설정할 수 있습니다.

사용자 지정#

이 통합 은 서버와 웹 앱 부분을 모두 포함합니다.

서버: /server 디렉토리 내에서 통합의 서버 측을 구성하는 Go 파일을 찾을 수 있습니다. 여기서 다른 Go 애플리케이션처럼 플러그인을 빌드하세요.
웹 앱: /webapp 디렉토리 내에서 플러그인의 클라이언트 측을 구성하는 JS 및 React 파일을 찾을 수 있습니다. 여기서 필요에 따라 파일과 컴포넌트를 수정하세요. npm run build 를 실행하여 구문을 테스트하세요.

Mattermost 기능 개발, 사용자 지정 및 확장에 대한 정보는 Mattermost 개발자 워크플로우 와 Mattermost 개발자 환경 설정 을 참조하세요.

업그레이드#

새 버전이 출시될 때 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리스, 이전 릴리스 및 호환성 고려사항에 대한 정보는 릴리스 페이지 를 참조하세요.

도움 받기#

Mattermost 고객은 Mattermost 지원 케이스 를 열 수 있습니다. 버그를 보고하려면 Mattermost Zoom 플러그인 저장소 에 GitHub 이슈를 등록하세요.

질문, 피드백 및 도움이 필요하시면 Mattermost 커뮤니티 서버 의 통합 및 앱 채널 에 참여하세요.

Mattermost Team Edition 및 무료 고객은 도움을 받기 위해 Mattermost 피어 투 피어 문제 해결 포럼 에서 글로벌 Mattermost 커뮤니티에 접근할 수 있습니다.