IM 앱¶

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

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

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

앱 연결¶

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

Lark 앱 연결¶

1. Lark 앱 만들기¶

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

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를 생성하거나 설정한 다음 연결 페이지에 입력합니다. 양쪽 값이 완전히 일치해야 하며, 그렇지 않으면 콜백 요청을 해독할 수 없습니다.

3. 앱 권한 활성화¶

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

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

연락처 데이터 범위 구성¶

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

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

연락처 데이터 범위에 초대 대상 구성원이 포함되어야 합니다

시스템은 권한이 부여된 범위 내의 Lark 사용자 정보만 가져올 수 있습니다. 구성원이 contact:user.id:readonly의 연락처 데이터 범위에 포함되지 않은 경우, 시스템은 이메일이나 휴대폰 번호로 해당 구성원을 찾을 수 없으므로 워룸 그룹 채팅을 만들 때 해당 구성원을 초대할 수 없습니다.

4. 카드 콜백 구성¶

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

“개발자 서버로 콜백 보내기”를 선택하고 연결 페이지에서 생성된 카드 콜백 URL을 입력합니다.
콜백 추가: card.action.trigger.

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

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

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

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

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

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

6. 연결 완료¶

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

Tencent Meeting 연결¶

플랜 및 계정 요구 사항

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

1. 기업 자체 구축 앱 만들기¶

다음 단계에 따라 기업 자체 구축 앱을 만듭니다.

Tencent Meeting 기업 관리자 계정으로 Tencent Meeting 공식 사이트에 로그인합니다.
페이지 오른쪽 상단의 아바타를 클릭해 사용자 센터로 이동한 뒤, 기업 관리 > 고급 > 기업 자체 구축 앱을 선택합니다.
앱 추가를 클릭해 앱 이름을 입력하고, 기업의 데이터 액세스 범위에 따라 앱 유형을 선택한 후 제출합니다. 앱 레벨은 권한 범위를 별도로 구성할 수 있으며, 기업 레벨은 기본적으로 기업 범위 내 데이터에 액세스할 수 있고 권한 범위 메뉴가 표시되지 않습니다.
새 앱으로 이동해 기본 정보를 보완하고 앱 상태를 사용 중으로 설정합니다.
앱 레벨 앱을 만든 경우, 기업 자체 구축 앱 목록에서 앱 이름을 클릭해 상세로 이동한 뒤 왼쪽의 권한 범위를 선택하고, 기업 회의 상세 정보 관리 권한을 검색해 활성화합니다. 이 권한은 회의를 만들고 참석 링크를 가져오는 데 사용됩니다. 권한에 승인이 필요하면 앱 관리자가 승인을 완료하세요. 기업 레벨 앱은 이 단계를 수행할 필요가 없습니다.

또는 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 워룸을 만들 때 시스템은 구성된 기업 구성원을 회의 생성자로 사용합니다.

앱 보기 및 관리¶

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

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를 할당했다면 해당 매개변수도 입력되었는지 확인해야 합니다. 그다음 앱이 사용 중 상태이고 기업 회의 상세 정보 관리 권한이 활성화되었는지 확인하고, 회의 생성자 User ID가 현재 기업 내에서 상태가 정상이고 회의 시작 권한이 있는 구성원을 가리키는지 확인하세요.

더 읽어보기¶

다음 내용이 도움이 될 수 있습니다.

워룸 만들기 및 사용