Sparkles Editor상상, 현실로.계정 및 충전
모든 가이드
채팅 채널

DingTalk AI 봇 연결 가이드: 실제 화면으로 권한·카드·게시 확인

DingTalk 기업 내부 앱 봇을 Sparkles에 연결하는 화면 안내입니다. 권한, JSON 카드 가져오기, 변수, 상태 미리보기와 게시 과정을 실제 화면으로 확인합니다.

DingTalk 기업 봇을 Sparkles에 연결하고 Stream, 권한, JSON 카드, 변수, 상태와 게시를 실제 화면으로 확인합니다.
원본 크기로 보기
실제 DingTalk 화면을 사용했으며 App Secret, 봇 키, 이메일과 잔액은 포함하지 않았습니다.

Stream 기업 앱을 사용하기

기업 내부 앱의 봇을 켜고 메시지 수신을 Stream으로 선택합니다. 그룹 Webhook 봇은 애플리케이션 봇을 대신할 수 없습니다.

Stream 모드를 선택한 DingTalk 봇 설정 페이지
실제 화면 캡처: 봇이 활성화되어 있고 Stream 모드로 설정되어 있습니다.
Stream 푸시를 선택한 DingTalk 이벤트 구독 페이지
실제 화면 캡처: 이벤트 페이지에 Stream 푸시 진입점이 표시됩니다.

필수 권한 확인하기

봇 메시지 전송, 카드 인스턴스 쓰기, AI 카드 쓰기와 스트리밍 업데이트 권한을 확인하고 변경 후 앱 버전을 게시합니다.

카드와 봇 기능이 활성화된 DingTalk 권한 관리 페이지
실제 화면 캡처: AI 카드 인스턴스 쓰기, 기업 봇 메시지 전송, 대화형 카드 인스턴스 쓰기, AI 카드 스트리밍 업데이트가 모두 활성화로 표시됩니다.

새 초안에 JSON 카드 가져오기

새 AI 카드 초안을 만든 뒤 더보기 → 카드 템플릿 가져오기를 눌러 v1.1 JSON을 선택합니다. 캔버스와 기업의 템플릿 ID를 확인합니다.

카드 템플릿 가져오기를 보여 주는 DingTalk 카드 빌더 더 보기 메뉴
실제 화면 캡처: 더 보기 메뉴에서 카드 템플릿 가져오기를 선택할 수 있습니다.
카드 구조와 설정 컨트롤을 보여 주는 DingTalk 카드 편집기 개요
실제 화면 캡처: 가져온 뒤 편집기 개요에서 구조, 버튼, 스타일을 확인합니다.
템플릿을 가져온 뒤의 DingTalk 카드 빌더 캔버스
실제 화면 캡처: 가져온 뒤 편집기에서 카드 구조와 버튼을 확인합니다.
Sparkles AI 어시스턴트 템플릿을 보여 주는 DingTalk 카드 템플릿 목록
실제 화면 캡처: 게시된 Sparkles AI assistant v1.1 컴팩트 템플릿과 템플릿 ID가 목록에 표시됩니다.

변수와 버튼 확인하기

content, status, openUrl, choiceCount와 여섯 개 choiceId/choiceLabel 쌍을 유지합니다. 변수는 표시용이고 세션과 권한은 Sparkles 서버가 관리합니다.

content, status, 선택 변수를 보여 주는 DingTalk 카드 빌더 변수 패널
실제 화면 캡처: 변수 패널에 content, status, openUrl, choiceId, choiceLabel 변수가 표시됩니다.

모든 상태 미리보기

미리보기에서 처리 중, 출력 중, 완료, 실패 상태를 확인합니다. 미리보기는 템플릿 확인이며 실제 봇 전달을 증명하지 않습니다.

Sparkles AI 어시스턴트 카드를 보여 주는 DingTalk 카드 빌더 미리보기 모드
실제 화면 캡처: 본문, 세 개의 선택 버튼, 작품과 대화 보기 링크가 표시됩니다.
DingTalk 카드 빌더 처리 중 상태
실제 화면 캡처: 처리 중 상태의 카드 미리보기입니다.
DingTalk 카드 빌더 출력 중 상태
실제 화면 캡처: 출력 중 상태의 카드 미리보기입니다.
DingTalk 카드 빌더 완료 상태
실제 화면 캡처: 완료 상태의 카드 미리보기입니다.
DingTalk 카드 빌더 실패 상태
실제 화면 캡처: 실패 상태의 카드 미리보기입니다.

게시 후 Sparkles에 연결하기

카드와 앱 버전을 게시한 뒤 Sparkles 전용 폼에 Client ID, Secret, Robot Code와 템플릿 ID를 입력합니다. 마지막으로 /status를 테스트합니다.

온라인 버전을 보여 주는 DingTalk 버전 관리 및 게시 페이지
실제 화면 캡처: 버전 1.0.1과 1.0.0이 온라인 상태입니다.

Sparkles로 돌아가 네 가지 값을 입력합니다

DingTalk 채널 설정에 Client ID / AppKey, Client Secret / AppSecret, Robot Code, 템플릿 ID를 입력합니다. 시크릿은 전용 폼으로만 제출하고 제출 후 페이지에서 지워지는지 확인합니다. 관리자 계정을 1:1 채팅에서 연결하고 /status를 보낸 다음 짧은 메시지와 첨부 파일 하나를 테스트합니다. 명시적으로 활성화하기 전까지 그룹은 비활성 상태입니다.

최종 수락 체크리스트

권한, 변수, 네 가지 미리보기, 게시된 템플릿 ID, 게시된 앱 버전, /status, 짧은 대화, 버튼 콜백, 첨부 파일 하나를 확인합니다. 처음에는 멘션만 허용하고 관리자만 사용하도록 시작합니다. 전달이 불확실하면 유료 요청을 다시 보내기 전에 기존 작업을 확인합니다.

출처와 관련 가이드

채널 설정 열기

로그인 후 Telegram 또는 Feishu / Lark를 연결하세요. 모델과 창작에는 계정의 기존 Credits와 이용 권한이 적용됩니다.