콘텐츠로 이동

IM 앱

IM 앱은 Lark 또는 Tencent Meeting을 연동하여 인시던트 워룸에 그룹 채팅 생성, 미팅 생성, 인시던트 정보 동기화 등의 기능을 제공합니다.

워크스페이스 관리 또는 연동 관리 권한이 있는 구성원은 연동 > IM 앱에서 연동된 앱을 조회하고 관리할 수 있습니다. 앱 목록에는 앱 정보와 연결 상태가 표시되며 앱 이름으로 검색할 수 있습니다. 앱을 클릭하면 상세 정보를 확인할 수 있습니다.

플랫폼 워룸 기능
Lark 비공개 그룹 채팅 생성, 구성원 초대, 인시던트 카드 전송 및 업데이트, 카드 작업 응답, 그룹 채팅 해산
Tencent Meeting 빠른 미팅 생성, 미팅 번호 및 참여 링크 생성

앱 연동

연동 > IM 앱으로 이동하여 앱 연동을 클릭한 뒤 연결할 플랫폼을 선택하고, 페이지 안내에 따라 자격 증명을 입력하고 플랫폼 측 구성을 완료합니다.

Lark 연동

1. Lark 앱 생성

  1. Lark 오픈 플랫폼에 로그인하여 기업 자체 구축 앱을 생성합니다.
  2. 앱 기능에서 봇 기능을 추가합니다.

2. 앱 매개변수 입력

연동 > IM 앱으로 이동하여 앱 연동을 클릭하고 Lark를 선택합니다. 앱 이름과 다음 매개변수를 입력합니다.

필드 필수 여부 설명
App ID 예 Lark 앱의 고유 식별자
App Secret 예 앱 액세스 토큰을 가져오는 데 사용. 암호화되어 저장되며 다시 표시되지 않음
Verification Token 예 카드 콜백이 현재 앱에서 온 것인지 검증하는 데 사용
Encrypt Key 예 Lark가 전송한 카드 콜백 요청을 복호화하는 데 사용

각 매개변수는 Lark 오픈 플랫폼에서 다음과 같이 확인할 수 있습니다.

  • App ID, App Secret: 개발자 콘솔 > 앱 선택 > 기본 정보 > 자격 증명 및 기본 정보에서 확인합니다.
  • Verification Token: 개발자 콘솔 > 앱 선택 > 개발 구성 > 이벤트 및 콜백 > 암호화 정책으로 이동하여 표시된 Verification Token을 복사합니다.
  • Encrypt Key: 암호화 정책 페이지에서도 동일하게 확인할 수 있습니다. 이 항목이 미사용으로 표시되면 재설정 또는 사용자 지정 편집을 클릭하여 Encrypt Key를 생성하거나 설정한 뒤 연동 페이지에 입력합니다. 양쪽 값은 완전히 일치해야 하며, 그렇지 않으면 콜백 요청을 복호화할 수 없습니다.

Verification Token이 숨겨진 Lark 오픈 플랫폼 이벤트 및 콜백 암호화 정책 페이지

3. 앱 권한 활성화

Lark 오픈 플랫폼의 권한 관리에서 앱에 다음 권한을 활성화합니다.

권한 용도
im:chat 워룸 그룹 채팅 생성, 관리 및 해산, 구성원 초대 및 그룹 공유 링크 생성
im:message 인시던트 카드 전송 및 업데이트
contact:user.id:readonly 이메일 또는 휴대폰 번호로 Lark 사용자 매칭, 자동 구성원 초대에 사용
조직도 데이터 범위 구성

contact:user.id:readonly를 활성화한 후에는 이 권한이 액세스할 수 있는 조직도 데이터 범위도 구성해야 합니다.

  1. 권한 관리에서 contact:user.id:readonly를 찾아 액세스 가능한 데이터 범위 > 구성을 클릭합니다.
  2. 조직도에서 전체 구성원을 선택하거나 액세스를 허용할 부서와 구성원을 지정합니다.
  3. 데이터 범위에 워룸에 초대될 수 있는 모든 구성원이 포함되도록 합니다.
조직도 데이터 범위가 초대될 구성원을 포함해야 합니다

시스템은 승인된 범위 내의 Lark 사용자 정보만 가져올 수 있습니다. 구성원이 contact:user.id:readonly의 조직도 데이터 범위에 없으면 시스템이 이메일이나 휴대폰 번호로 해당 구성원을 찾을 수 없으며, 워룸 그룹 채팅을 만들 때 해당 구성원을 초대할 수 없습니다.

4. 카드 콜백 구성

자격 증명 검증이 완료되면 연동 페이지 3단계에서 카드 콜백 URL이 생성됩니다. Lark 오픈 플랫폼의 개발 구성 > 이벤트 및 콜백 > 콜백 구성으로 이동하여 다음 구성을 완료합니다.

  1. 개발자 서버로 콜백 전송을 선택하고 연동 페이지에서 생성된 카드 콜백 URL을 입력합니다.
  2. 콜백 추가: card.action.trigger.

개발자 서버로 콜백을 전송하도록 선택한 Lark 오픈 플랫폼 콜백 구성 페이지

카드 콜백은 나중에 구성할 수 있습니다. 콜백을 구성하지 않아도 앱이 연결됨 상태로 표시되고 그룹 채팅을 생성할 수 있지만, 그룹 내 인시던트 카드의 담당자 지정, 종료 등의 작업은 사용할 수 없습니다.

5. 앱 게시 및 사용 가능 범위 설정

앱을 반드시 게시하고 사용 가능 범위를 올바르게 설정해야 합니다

반드시 Lark 오픈 플랫폼에서 앱 버전을 게시하고 앱의 사용 가능 범위를 전체 구성원으로 설정하거나, 워룸을 생성, 처리 및 참여할 수 있는 모든 구성원을 포함하도록 해야 합니다. 앱이 게시되지 않았거나 사용 가능 범위가 너무 좁으면 관련 구성원의 Lark 계정을 조회할 수 없어 자동 그룹 채팅 생성이 실패합니다.

  1. Lark 오픈 플랫폼의 앱 게시 > 버전 관리 및 게시로 이동하여 버전 만들기를 클릭합니다.
  2. 앱의 사용 가능 범위를 전체 구성원으로 설정합니다. 범위를 제한해야 하는 경우 부서와 구성원을 지정할 수 있지만, 워룸을 생성, 처리 및 참여할 수 있는 모든 구성원을 포함해야 합니다.
  3. 버전을 제출하고 게시를 완료합니다.

일부 구성원이나 부서를 선택한 경우 워룸 사용 인원이 변경되면 사용 가능 범위를 즉시 조정하고 앱 버전을 다시 게시하세요.

6. 연동 완료

앱 자격 증명 검증이 완료되면 앱 상태가 연결됨으로 표시됩니다. 위 단계에 따라 앱 권한, 카드 콜백, 앱 게시 및 사용 가능 범위가 모두 구성되었는지 확인한 후 해당 앱으로 워룸을 생성하세요. 앱 상세의 콜백 구성에서 콜백 상태를 확인하거나 콜백 주소를 복사할 수 있습니다.

Tencent Meeting 연동

버전 및 계정 요구 사항

연동 기업은 Tencent Meeting 상용 플랜, 기업용 플랜 또는 교육용 플랜을 사용해야 합니다. 개인 플랜, 무료 조직, 그리고 상용 플랜·기업용 플랜·교육용 플랜의 무료 계정은 기업 자체 구축 앱을 만들 수 없습니다. 미팅을 생성하는 기업 구성원은 미팅 생성 자격도 갖추어야 합니다. 플랫폼 지원 범위를 확인하려면 Tencent Meeting의 앱 유형 소개를 참조하세요.

1. 기업 자체 구축 앱 생성

다음 단계에 따라 기업 자체 구축 앱을 생성합니다.

  1. Tencent Meeting 기업 관리자 계정으로 Tencent Meeting 공식 사이트에 로그인합니다.
  2. 페이지 오른쪽 상단의 프로필을 클릭하여 사용자 센터로 이동한 뒤 기업 관리 > 고급 > 기업 자체 구축 앱을 선택합니다.

  3. 앱 추가를 클릭하고 앱 이름을 입력한 다음 기업의 데이터 액세스 범위에 따라 앱 유형을 선택합니다. 앱 레벨은 권한 범위를 별도로 구성할 수 있고, 기업 레벨은 기본적으로 기업 범위 내 데이터에 액세스할 수 있으며 권한 범위 메뉴가 표시되지 않습니다.

    화이트리스트 구성: Guance가 Tencent Meeting API를 정상적으로 호출할 수 있도록 현재 워크스페이스가 속한 사이트에 따라 전역 화이트리스트에 해당 IP 주소를 입력합니다. 여러 IP 주소는 줄바꿈으로 구분합니다.

    사이트 IP 주소
    cn1 47.97.178.215
    cn2 68.79.7.77
    cn3 115.191.33.136
    cn4 124.71.63.1
    cn6 8.217.159.66
    eu2 94.139.255.222
    ap1 3.1.104.3
    ap2 47.84.142.109
    eu1 18.157.152.101
    id1 43.129.51.192
    us1 35.164.41.209
    za1 203.123.87.65

    여러 IP 주소를 줄바꿈으로 구분하는 Tencent Meeting 기업 자체 구축 앱 생성 팝업의 전역 화이트리스트 구성

    위 구성을 완료한 후 앱을 제출합니다.

  4. 새 앱에 진입하여 기본 정보를 보완하고 앱 상태를 사용 중으로 설정합니다.

  5. 앱 레벨 앱을 만든 경우 기업 자체 구축 앱 목록에서 앱 이름을 클릭하여 상세로 이동하고, 왼쪽의 권한 범위를 선택한 뒤 기업 회의 상세 정보 관리 권한을 검색하여 활성화합니다. 이 권한은 미팅을 생성하고 참여 링크를 가져오는 데 사용됩니다. 권한에 승인이 필요한 경우 앱 관리자가 승인을 완료합니다. 기업 레벨 앱은 이 단계를 수행할 필요가 없습니다.

Tencent Meeting 기업 자체 구축 앱 관리 콘솔을 직접 열 수도 있습니다. Tencent Meeting 플랫폼의 전체 생성 규칙을 확인하려면 기업 자체 구축 앱 사용 설명을 참조하세요.

앱 생성 후 다음 매개변수를 확인하고 연동 > IM 앱에서 앱 연동 > Tencent Meeting을 클릭하여 입력을 완료합니다.

필드 필수 여부 설명
App ID 예 Tencent Meeting 콘솔의 기업 ID에 해당
Secret ID 예 기업 자체 구축 앱의 인증 자격 증명
Secret Key 예 기업 자체 구축 앱의 인증 키
미팅 생성자 User ID 예 미팅 생성에 사용되는 고정 기업 구성원 User ID
SDK ID 기업 구성에 따라 다름 Tencent Meeting이 앱에 SDK ID를 할당한 경우 필수. 할당되지 않은 경우 비워 둠

매개변수는 다음과 같은 위치에서 확인할 수 있습니다.

  • App ID, Secret ID, Secret Key: 기업 관리 > 고급 > 기업 자체 구축 앱으로 이동하여 앱을 선택한 뒤 기본 정보 및 자격 증명에서 함께 확인합니다. 연동 페이지의 App ID는 Tencent Meeting 콘솔의 기업 ID에 해당하며, 기업 관리 > 계정 관리 > 계정 정보에서도 확인할 수 있습니다.
  • SDK ID: 기본 정보 및 자격 증명에서 동일하게 확인합니다. 이 페이지에 SDK ID가 표시되면 반드시 입력해야 하며, 표시되지 않으면 비워 둡니다.
  • 미팅 생성자 User ID: 기업 관리 > 사용자 관리 > 사용자 목록으로 이동하여 미팅 생성에 사용할 기업 구성원을 찾아 해당 UserID를 복사합니다. 목록에 이 필드가 표시되지 않으면 목록 필드 설정을 통해 표시할 수 있습니다. 이 구성원은 정상 상태여야 하며 미팅 시작 권한이 있어야 합니다.

민감한 값이 숨겨진 Tencent Meeting 기업 자체 구축 앱의 기본 정보 및 자격 증명 페이지

매개변수를 입력하고 자격 증명 검증을 완료하면 연동이 완료됩니다. 이후 Tencent Meeting 워룸을 생성할 때 시스템은 구성된 기업 구성원을 미팅 생성자로 사용합니다.

앱 조회 및 관리

앱 행을 클릭하여 상세로 이동하면 기본 정보, 연결 상태, 워룸 기능 및 작업 기록을 확인할 수 있습니다.

  • Lark 앱은 콜백 구성을 제공하며, 카드 콜백 URL을 확인하고 복사할 수 있습니다.
  • 앱 이름과 앱 자격 증명 등의 정보를 수정할 수 있습니다.
  • 상세 페이지에서 불필요한 앱을 선택하여 삭제할 수 있습니다.

Lark 카드 콜백 URL은 IM 앱 관리 권한이 있는 워크스페이스 관리자만 조회하고 복사할 수 있습니다. 조회, 복사, 구성 변경 및 앱 삭제 등의 작업은 모두 감사 기록에 남습니다.

앱 삭제 전에 재확인이 필요합니다. 삭제 후 구성은 복구할 수 없으며 더 이상 새 워룸을 만드는 데 사용할 수 없습니다. 이미 생성된 외부 그룹 채팅, 미팅 및 액세스 기록은 영향을 받지 않습니다.

연결 상태

상태 설명
확인 대기 앱 자격 증명이 아직 검증되지 않음. 워룸 생성에 사용할 수 없음
연결됨 자격 증명과 기본 기능 검증이 완료됨. 워룸 생성에 사용할 수 있음
연결 오류 자격 증명 만료, 권한 부족 또는 기업 측 앱 사용 불가. 새 워룸을 생성할 수 없음

Lark 앱은 별도로 콜백 구성 상태를 표시합니다.

상태 설명
구성 대기 검증된 카드 콜백을 아직 수신하지 못함. 그룹 채팅은 계속 생성할 수 있지만 카드 작업은 사용할 수 없음
정상 출처 검증을 통과한 카드 콜백을 수신함
오류 콜백에 계속 접근할 수 없거나 서명 검증·복호화에 실패함. Lark 플랫폼과 앱 상세의 콜백 구성을 확인하세요

앱 연결에 오류가 발생하면 페이지 안내에 따라 자격 증명, 앱 권한 및 앱 사용 가능 범위를 확인하세요. 기존 워룸의 외부 그룹 채팅이나 미팅은 이로 인해 자동으로 닫히지 않습니다.

자주 묻는 질문

앱 연동이 완료되지 않는 이유는 무엇인가요?

페이지 안내에 따라 다음 구성을 확인하세요.

  • 앱 자격 증명이 올바른지
  • Lark 앱에 봇 기능이 추가되고 앱 버전이 게시되었는지
  • Lark 권한, 조직도 데이터 권한 및 앱 사용 가능 범위가 완전히 구성되었는지
  • Tencent Meeting 기업 플랜, 앱 권한 및 미팅 생성 계정이 요구 사항을 충족하는지

연동된 앱으로 워룸을 생성할 수 없는 이유는 무엇인가요?

연결됨 상태인 앱만 워룸을 생성할 수 있습니다. 앱 상세에서 연결 상태와 작업 기록을 확인하고 오류 안내에 따라 구성을 수정하세요.

Secret 교체 후 플랫폼 권한을 다시 구성해야 하나요?

앱 ID와 앱 자체가 변경되지 않았다면 Secret만 교체하는 경우 일반적으로 플랫폼 권한이나 콜백을 다시 활성화할 필요가 없습니다. 새 Secret을 저장한 후 앱이 연결됨 상태로 복구되었는지 확인하세요.

Lark 앱이 연결됨 상태인데 카드 작업이 동작하지 않는 이유는 무엇인가요?

앱 상세에서 콜백 구성 상태를 확인하세요.

  • 상태가 구성 대기인 경우: 카드 콜백 URL을 Lark 오픈 플랫폼에 구성하고 card.action.trigger 콜백을 추가하세요.
  • 상태가 오류인 경우: 콜백 주소를 확인하고 Verification Token과 Encrypt Key가 Lark 오픈 플랫폼의 구성과 완전히 일치하는지 확인하세요.

콜백이 정상으로 복구되기 전까지 Lark 그룹 채팅을 만들고 참여할 수는 있지만, 그룹 내 인시던트 카드 작업은 처리할 수 없습니다.

Tencent Meeting 앱이 연결됨 상태인데 미팅 생성에 실패하는 이유는 무엇인가요?

App ID, Secret ID, Secret Key가 올바르게 입력되었는지 확인하세요. Tencent Meeting이 앱에 SDK ID를 할당한 경우 해당 매개변수도 입력되었는지 확인해야 합니다. 그런 다음 화이트리스트 구성에 현재 워크스페이스가 속한 사이트의 IP 주소가 포함되어 있는지, 앱이 사용 중 상태이고 기업 회의 상세 정보 관리 권한이 활성화되었는지 확인하고, 미팅 생성자 User ID가 현재 기업 내에서 정상 상태이며 미팅 시작 권한이 있는 구성원에 해당하는지도 확인하세요.

추가 자료

다음 내용도 확인해 보세요.

문서 평가

이 페이지가 도움이 되었나요?