상담 매뉴얼과 추가 자료는 미리 정리해 둔 정보를 답변에 쓰는 방식입니다. 그런데 재고 수량이나 예약 현황처럼 시시각각 바뀌는 정보는 미리 적어둘 수가 없습니다.
외부 API 연동을 사용하면 회사가 이미 보유한 시스템이나 외부 서비스를 상담 매뉴얼과 연결해, AI가 상담 도중 실시간 정보를 직접 조회하거나 처리하도록 만들 수 있습니다.
대시보드에서 채널을 선택한 뒤 외부 API 버튼을 클릭하세요.
어떤 것을 연동할 수 있나
- DB 접속 — 재고, 예약, 회원 정보 등 사내 데이터 조회
- 위치·거리 조회 — 가까운 매장 안내, 배송 가능 지역 확인
- SMS·알림 발송 — 상담 결과나 예약 확인 메시지 전송
- 실시간 공개 API — 날씨, 환율 등
연동 순서
전체 과정은 다섯 단계입니다.
- API 등록
- Function 등록
- 파라미터 설정
- 테스트
- 상담에서 활용
이 가이드에서는 공개된 날씨 API(OpenWeather)를 예시로 전체 과정을 안내합니다. 이 문서에서는 첫 단계인 API 등록을 다루고, 이어지는 Function과 파라미터 설정, 테스트와 실제 적용에서 나머지를 설명합니다.
API 관리 탭 열기
외부 API 화면은 API 관리와 Functions 두 개의 탭으로 구성됩니다. 먼저 API 관리 탭에서 연결할 서비스를 등록합니다.
API 관리 탭을 선택한 뒤 API 추가 버튼을 클릭하세요.

입력 항목
| 항목 | 내용 |
|---|---|
| API 이름 | 목록에서 구분할 이름 (예: 날씨 API) |
| Base URL | 호출할 서비스의 기본 주소 (예: https://api.openweathermap.org/data/2.5) |
| 인증 방식 | API Key, Bearer Token 등 서비스가 요구하는 방식 선택 |
| API Key | 서비스에서 발급받은 인증 키 입력 |

Base URL을 정할 때
Base URL은 변하지 않는 앞부분까지만 입력합니다. 뒤에 붙는 경로(/weather 등)는 다음 단계인 Function에서 지정합니다.
이렇게 나누는 이유는 하나의 API에 여러 기능을 연결하기 위해서입니다. 같은 서비스에서 날씨 조회와 예보 조회를 모두 쓴다면, Base URL은 한 번만 등록하고 Function만 두 개 만들면 됩니다.
인증 정보를 준비하세요
API Key는 연동하려는 서비스에서 미리 발급받아야 합니다. OpenWeather 같은 공개 서비스는 가입 후 바로 발급되지만, 사내 시스템이라면 담당 개발자에게 요청해야 할 수 있습니다.
준비할 것은 세 가지입니다. Base URL, 인증 방식, 인증 키. 이 정보는 대부분 해당 서비스의 API 문서 첫 페이지에 나와 있습니다.
등록 확인
등록이 완료되면 API 목록에 카드 형태로 표시됩니다.
- API 이름, 연결된 Function 개수, Base URL, 인증 방식을 한눈에 확인할 수 있습니다
- 수정 버튼으로 정보를 변경하고, 휴지통 아이콘으로 삭제합니다

연결된 Function 개수가 0으로 표시된다면 아직 실제로 호출할 기능을 만들지 않은 상태입니다. API 등록만으로는 상담에서 동작하지 않습니다.
다음 단계
외부 API 연동 (2) — Function과 파라미터 설정에서 실제로 호출할 기능을 정의합니다.

