---
title: "LINE Switcher API 연동"
slug: "chatbot-chatbot-6-1"
tags: ["챗봇", "CLOVA Chatbot", "상담원 연동", "chatbot"]
updated: 2026-07-23T09:02:16Z
published: 2026-07-23T09:02:16Z
canonical: "guide-fin.ncloud-docs.com/chatbot-chatbot-6-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LINE Switcher API 연동

LINE Switcher API는 상담원 연동 API로, LINE 메신저 채널에서 지원하는 기능입니다. LINE Switcher API를 통해 상담원과 연결하도록 설계된 대화를 제작할 수 있습니다. 상담원 연결에 필요한 제반 사항이 LINE 메신저 환경에서 준비되었을 경우에만 정상 동작합니다.

LINE Switcher API와 연동하기 전에 수행해야 할 작업은 다음과 같습니다.

- [API Gateway Invoke URL 생성](/docs/chatbot-chatbot-5-1)
- [LINE Business 계정 생성](/docs/chatbot-chatbot-5-2#LINEBusiness%EA%B3%84%EC%A0%95%EC%83%9D%EC%84%B1)
- LINE Switcher API연동 시 필요한 정보 확인
  - CLOVA Chatbot의 Switcher secret 정보
  - Operation Agent의 Destination ID

LINE Switcher API와 연동한 후에 수행해야 할 작업은 다음과 같습니다.

- 상담원 연결을 위한 대화 생성

## LINE Switcher API 연동

LINE Switcher API를 연동하는 방법은 다음과 같습니다.

1. LINE Business Center에 접속해 주십시오.
2. 계정 이름을 클릭해 주십시오.
  - 해당 계정의 관리 페이지로 이동
3. 화면 우측 상단에 있는 **[설정]** 을 클릭해 주십시오.
4. **설정** > **Messaging API** > **[Messaging API 켜기]** 버튼을 클릭해 주십시오
5. 개발자 정보 등록 창이 나타나면 개발자 정보를 입력하고 **[동의]** 버튼을 클릭해 주십시오.
6. 운영 담당을 입력하고 **[동의]** 버튼을 클릭해 주십시오.

## LINE Switcher API 연동 시 필요한 정보 확인

LINE Developers의 Switcher API Tab에서 Switcher secret, Destination ID 정보를 확인하는 방법은 다음과 같습니다.

1. LINE Developers(https://developers.line.biz/en/)에 접속해 주십시오.
2. **[Console]** 버튼을 클릭한 후 계정 이름을 클릭해 주십시오.
3. Switcher API 탭에서 **[Add]** 버튼을 클릭해 주십시오.
  - Switcher API 탭은 LINE과 Switcher API를 계약한 법인인 경우에만 활성화  

![chatbot-chatbot-6-1_switcherapi_ko.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/chatbot-chatbot-6-1_switcherapi_ko.png)
4. CLOVA Chatbot 용 Destination Name과 Webhook URL을 입력하고 생성해 주십시오.
5. Switcher Secret 정보를 복사하여 저장해 주십시오.
6. Operation Agent 용 Destination Name과 Webhook URL을 입력하고 생성해 주십시오.
7. Destination ID 정보를 복사하여 저장해 주십시오.

## 챗봇 빌더에서 LINE Switcher API 연동 설정

챗봇 빌더에서 챗봇과 LINE Switcher API를 연동하는 방법은 다음과 같습니다.

1. 사전 작업을 완료해 주십시오.
  - API Gateway 연동
  - 연동 시 필요한 정보 확인
2. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI Services** > **CLOVA Chatbot** > **Domain** 메뉴를 차례대로 클릭해 주십시오.
3. 원하는 도메인의 **[빌더 실행하기]** 버튼을 클릭하여 챗봇 빌더를 실행해 주십시오.
4. 챗봇 빌더에서 **챗봇 설정** > **서비스 연동 탭**을 클릭해 주십시오.
5. LINE Switcher API의 **[연동]** 버튼을 클릭해 주십시오.
6. 서비스 연동 창에서 Switcher secret, Destination ID를 입력해 주십시오.
  - 입력할 값을 확인하는 방법은 [LINE Switcher API 연동 시 필요한 정보 확인](/docs/chatbot-chatbot-6-1#LINESwitcherAPI%EC%97%B0%EB%8F%99%EC%8B%9C%ED%95%84%EC%9A%94%ED%95%9C%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8)을 참조해 주십시오.
7. 상담원 연결 실패 시 전달할 문구를 입력해 주십시오.
8. **[연동]** 버튼을 클릭해 주십시오.

## 상담원 연결 대화 생성

- Line switcher API 연동이 완료되면 액션 메소드 메뉴에 상담원 연결을 위한 액션 메소드 ${'lineSwitcherApi}가 노출됩니다. 액션 메소드 ${'lineSwitcherApi}를 수정할 경우, API와 함께 전달할 수 있는 노트를 최대 10개까지 작성할 수 있습니다. 예를 들어 `${'lineSwitcherApi(shopping)}`을 등록할 경우, 'Shopping' string을 API에 전달해서 Shopping 카테고리 상담원이 응답할 수 있습니다. ![chatbot-chatbot-6-1_cs01_ko.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/chatbot-chatbot-6-1_cs01_ko.png)
- 대화 생성 시 상담원 연결을 원하는 대화의 답변에 액션 메소드 ${'lineSwitcherApi}를 입력하면 상담원 연결 설정이 완료됩니다. ![chatbot-chatbot-6-1_cs02_ko.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/chatbot-chatbot-6-1_cs02_ko.png)