외부연동
네이버웍스, 네이버 Open API 같은 외부 서비스의 인증 정보를 등록해 Dotory Chat과 연결합니다.
외부연동
외부연동은 Dotory Chat이 사외 서비스의 API를 사용할 수 있도록 인증 정보(Client ID·Secret 등)를 보관하는 곳입니다. 한 번 등록해 두면, AI 채팅이나 업무 자동화가 해당 서비스를 호출해야 할 때 저장된 인증 정보를 사용해 동작합니다.
현재 지원하는 연동은 다음과 같습니다.
-
네이버웍스
NAVER WORKS Bot API. Bot 인증 정보를 저장하고, Bot별로 메시지 발송 테스트까지 진행할 수 있습니다.
-
네이버 Open API
뉴스·블로그 검색 등 네이버 Open API. AI 채팅에서 외부 정보 조회가 필요한 경우 사용됩니다.
⚠️
저장된 인증 정보(특히 Client Secret과 Private Key)는 외부에 노출되지 않도록 주의하세요. 관리자 계정으로 로그인한 사람만 이 화면에 접근할 수 있습니다.
외부연동 선택
-
1
서비스 카드: 좌측 목록에서 설정할 외부 서비스를 선택합니다. 현재는 네이버웍스와 네이버 Open API를 제공합니다.
-
2
등록 상태: 이미 저장된 서비스는 카드 끝에 초록 체크 아이콘이 표시됩니다. 등록되지 않은 서비스는 선택하면 빈 설정 폼이 열립니다.
-
3
문의 배너: 원하는 외부연동이 없거나 설정이 어려울 때 문의 페이지 또는 관리자 가이드로 이동합니다.
네이버웍스 등록하기
NAVER WORKS의 개발자 콘솔에서 발급한 Bot 인증 정보를 입력합니다.
-
1
좌측에서 네이버웍스 카드를 클릭합니다. 기존 등록이 없으면 빈 폼이, 있으면 저장된 값이 채워진 폼이 열립니다.
-
2
Client ID, Client Secret, Service Account, Private Key (PEM), Scope를 입력합니다.
-
3
설정정보 연결확인으로 인증이 정상 동작하는지 먼저 확인한 뒤, 문제가 없으면 저장을 누릅니다.
-
4
아래 Bot 목록에서 사용할 Bot 정보를 추가하고, 각 Bot에 대해 메시지 테스트를 실행합니다.
입력 항목 상세
Client ID
NAVER WORKS Developer Console에서 발급한 앱의 식별자입니다.
Client Secret
앱 비밀 키입니다. 입력값은 화면에 마스킹되어 표시됩니다.
Service Account
JWT 인증에 사용하는 서비스 계정 ID입니다.
Private Key (PEM)
PEM 형식의 개인 키 전체를 붙여넣습니다. 저장 후에는 첫 줄과 마지막 줄만 표시되어 보안을 유지합니다. 다시 수정하려면 텍스트영역을 클릭해 전체 내용을 확인할 수 있습니다.
Scope
필요한 권한 범위입니다. Bot 메시지 발송이 목적이라면 기본값 bot을 그대로 사용합니다.
Bot 등록과 메시지 테스트
네이버웍스는 같은 인증 정보 아래 여러 Bot을 등록해 둘 수 있습니다.
-
1
Bot 추가 버튼으로 새 행을 추가하고, Bot 이름·Bot ID·Channel ID를 입력합니다.
-
2
메시지 테스트 버튼을 누르면 해당 Bot으로 실제 메시지가 발송됩니다. 결과는 단계별 성공/실패 메시지로 표시됩니다.
-
3
필요 없는 Bot은 휴지통 아이콘으로 제거합니다(최소 1개는 남겨야 함).
⚠️
메시지 테스트는 실제 네이버웍스 사용자에게 메시지를 보냅니다. 테스트용 채널/Bot으로 진행하거나, 받는 사람에게 사전에 알린 뒤 실행하세요.
네이버 Open API 화면 구성
네이버 Open API를 선택하면 뉴스·블로그 검색 등에 사용하는 네이버 개발자센터 인증 정보를 관리하는 화면이 열립니다.
-
1
인증 정보 입력: 네이버 개발자센터에서 발급받은 Client ID와 Client Secret을 입력합니다.
-
2
설정정보 연결확인: 입력한 인증 정보로 네이버 Open API를 정상 호출할 수 있는지 확인합니다.
-
3
저장: 연결 확인이 성공하면 저장을 눌러 AI 채팅과 업무 자동화에서 사용할 운영 값으로 반영합니다.
입력 항목 상세
Client ID
네이버 개발자센터에서 애플리케이션을 등록한 뒤 발급받는 공개 식별자입니다.
Client Secret
네이버 Open API 호출 권한을 확인하는 비밀 키입니다. 외부에 노출되지 않도록 관리하고, 입력값은 화면에서 마스킹되어 표시됩니다.
연결 테스트 결과 읽는 법
테스트 버튼을 누르면 결과 박스에 단계별 체크가 표시됩니다.
-
설정정보 연결확인
인증 정보(Client ID/Secret 등)로 토큰을 정상 발급받을 수 있는지 검사합니다. 성공하면 설정정보 연결확인 성공, 실패하면 어느 단계에서 막혔는지가 표시됩니다.
-
Bot 메시지 테스트
실제 메시지가 발송되었는지까지 확인하는 종단 테스트입니다. 토큰 발급 → 채널 확인 → 메시지 발송 등의 단계별 결과를 확인할 수 있습니다.
💡
연결 테스트가 성공하면 입력값을 다시 확인한 뒤 저장을 눌러 운영 설정으로 반영하세요.
자주 묻는 질문
연결 테스트를 누르면 입력값이 자동으로 저장되나요?
아니요. 먼저 설정정보 연결확인으로 입력값이 유효한지 확인한 뒤, 문제가 없을 때 저장을 눌러 운영 값으로 반영하세요.
Private Key가 줄어든 채로 저장되는 것 아닌가요?
아닙니다. 저장된 Private Key는 화면을 다시 열 때 보안을 위해 축약 표시됩니다. 입력 영역을 수정하지 않으면 기존 원본 값이 유지되고, 새 키를 붙여 넣은 경우에만 새 값으로 교체됩니다.
Bot 테스트 버튼이 비활성화되어 있습니다.
Bot ID가 비어 있으면 테스트할 대상을 알 수 없어 버튼이 비활성화됩니다. 네이버웍스 Bot 테스트는 Bot ID와 테스트 채널 ID가 필요하며, 빈 Bot 행은 저장 대상에서 제외됩니다.
저장 후 목록으로 돌아오면 Secret 값이 별표로 보입니다.
정상입니다. 목록 화면에서는 Client Secret, Private Key, 토큰 같은 민감 정보를 마스킹해서 보여줍니다. 편집 화면에서는 권한이 있는 관리자만 실제 값을 불러와 수정할 수 있습니다.
왼쪽 목록에 없는 외부 서비스도 직접 추가할 수 있나요?
현재 화면은 제공되는 템플릿을 기준으로 설정합니다. 목록에 없는 서비스가 필요하면 하단의 문의 배너를 통해 서비스명, 인증 방식, 사용 시나리오를 전달해 주세요.