본문으로 건너뛰기

대시보드 푸시 - Feishu 자체 개발 앱 봇 푸시 설정 안내

최근 업데이트 2026. 10. 05.

대시보드 즉시 푸시 또는 대시보드 정기 푸시에서 Feishu 봇 푸시를 선택하는 경우, 이미지 업로드를 지원하는 Feishu 앱을 준비하고 다음 앱 정보를 제공해야 합니다:

i) 기업 자체 개발 앱의 App ID

ii) 기업 자체 개발 앱의 App Secret

또한 푸시에 사용할 봇을 준비하고 다음 정보를 제공해야 합니다:

iii) 푸시 봇의 Webhook 주소

위의 i) APP ID와 ii) APP Secret 정보를 얻으려면 회사의 Feishu 관리자에게 문의하거나 Feishu 개발자 콘솔에서 앱 상세 정보를 확인해야 합니다. 푸시를 지원하는 앱이 아직 없다면 기업 자체 개발 앱을 생성해야 하므로, 먼저 관리자에게 관련 권한이 있는지 확인하십시오. 이미 앱 정보가 있다면 APP ID와 APP Secret을 얻은 후 바로 2단계로 진행할 수 있습니다.

1단계. 앱 생성​

아래 절차를 참고하십시오. 약 10-15분이 소요됩니다.

1. 기업 자체 개발 앱 생성​

(약 3분 소요)

  1. Feishu 워크벤치에서 또는 링크 https://open.feishu.cn/app/를 클릭하여 Feishu에 로그인한 후 Feishu 오픈 플랫폼에 진입합니다. Create Custom App을 선택합니다.
  1. 자체 개발 앱의 이름을 지정합니다. 앱 이름은 "ThinkingAI 푸시", 앱 설명은 "ThinkingAI AE 시스템의 푸시 메시지로, 이미지, 텍스트, 링크 등의 형식을 지원합니다."로 하고, 앱 아이콘은 아래 그림의 ThinkingAI 로고를 사용하는 것을 권장합니다. Create를 클릭하여 생성을 완료합니다.

화면 미리보기:

2. 봇 푸시 활성화​

(약 5분 소요)

  1. Add Features에서 Bot을 추가하고 설정 화면으로 이동합니다.
  1. 이미지 푸시 권한을 활성화합니다. 일간 리포트는 기본적으로 대시보드 이미지를 푸시하므로, 일간 리포트가 정상적으로 푸시되도록 관련 권한을 활성화해야 합니다. Permissions & Scopes - API Scopes에서 이름이 im:resource인 권한을 검색하여 선택한 후 Confirm을 클릭합니다.

3. 앱 게시​

(약 5-10분 소요, 기업 관리자의 처리 필요)

  1. App Release에서 Version Management & Release를 찾아 버전을 생성합니다
  1. 앱을 게시할 때는 관리하기 쉽도록 앱 버전 번호를 지정해야 합니다. Create a version을 선택한 후 필요한 정보를 입력합니다.

앱 버전 번호는 "1.0.0", 업데이트 설명은 "대시보드 이미지·텍스트 및 링크 푸시 지원"으로 입력하는 것을 권장합니다.

  1. 이 앱은 게시 후 기본적으로 생성자만 사용할 수 있으며, 필요에 따라 All members로 변경할 수 있습니다. 앱의 기능과 권한을 확인한 후 Save를 클릭하고 게시를 신청합니다
  1. 기업 관리자의 심사가 승인되면 앱 상태가 Pending release에서 Enabled로 바뀌며, 자체 개발 앱의 현재 버전이 게시됩니다.

변경 후:

4. App ID와 App Secret 가져오기​

(약 2분 소요)

  1. 앱 상세 화면의 메뉴에서 Credentials & Basic Info 페이지로 이동하여 App Credentials를 찾습니다.
  2. App ID를 복사하여 푸시 설정에 입력합니다. App ID는 변경되지 않습니다.
  3. 클릭하여 App Secret을 표시한 후 복사하여 푸시 설정에 입력합니다.

여러 대시보드 푸시 작업에서 App ID와 App Secret 정보를 함께 사용할 수 있으므로 앱을 다시 생성할 필요가 없습니다.

2단계. 커스텀 봇으로 푸시​

아래 단계는 커스텀 봇을 설정하는 방법 중 하나입니다. 다른 설정 방법은 Feishu 공식 문서 Webhook 주소 가져오기 절차를 참고하십시오.

1. 그룹에 커스텀 봇 추가​

Feishu에서는 Group chat 또는 Topic group에 커스텀 봇을 추가할 수 있습니다.

  1. (선택 사항) 토픽 그룹 만들기: Feishu의 + 메뉴에서 Create Group을 선택합니다.
  1. 그룹의 Settings에서 Bots를 추가하고 Custom Bot을 선택합니다

2. 봇 푸시 설정​

  1. Webhook 주소를 가져옵니다
  1. 해당 webhook 주소를 복사하여 대시보드 푸시 설정에 입력합니다
  1. (선택 사항) 커스텀 봇 보안 설정. 관련 없는 푸시가 이 webhook 주소를 사용하지 않도록 키워드를 설정할 수 있습니다. 키워드를 설정하면 일간 리포트 푸시의 텍스트 내용에 해당 키워드가 반드시 포함되어야 푸시에 성공합니다. 푸시할 텍스트 내용은 대시보드 푸시의 푸시 메시지에서 편집할 수 있습니다.

Feishu 앱 및 봇 설정 완료 후 주의 사항​

  1. 앱에 대해 추가 개발이 필요한 경우 Feishu 앱 개발 절차 및 도구 소개를 참고하십시오.
  2. 위 절차로 생성한 기업 자체 개발 앱은 여러 대시보드의 푸시를 지원하므로 앱을 다시 생성할 필요가 없으며, 여러 대시보드 푸시 작업에서 App ID와 App Secret 정보를 함께 사용할 수 있습니다.
  3. App Secret을 자주 초기화하지 마십시오. App Secret을 초기화하면 AE 시스템이 app_access_token을 얻을 수 없게 되어 기존 푸시 규칙이 무효화됩니다. App Secret을 이미 초기화했다면 AE 시스템의 대시보드 푸시 규칙에 새 App Secret을 직접 입력해야 합니다.
이 문서가 도움이 되었나요?
이 페이지의 내용