--- title: "LINE Switcher API 연동" slug: "chatbot-chatbot-6-1" tags: ["CLOVA Chatbot", "chatbot", "상담원 연동", "챗봇", "LINE 연동"] updated: 2026-09-17T09:07:06Z published: 2026-09-17T09:07:06Z canonical: "guide.ncloud-docs.com/chatbot-chatbot-6-1" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # LINE Switcher API 연동 Classic/VPC 환경에서 이용 가능합니다. 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](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-6-1_switcherapi_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A06%3A31Z&se=2026-10-26T22%3A06%3A31Z&sr=c&sp=r&sig=jhtpRoRjhMUu1%2BGhKZLCJuWLSovb7fI85d2PyaDnWH8%3D) 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](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-6-1_cs01_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A06%3A31Z&se=2026-10-26T22%3A06%3A31Z&sr=c&sp=r&sig=jhtpRoRjhMUu1%2BGhKZLCJuWLSovb7fI85d2PyaDnWH8%3D) - 대화 생성 시 상담원 연결을 원하는 대화의 답변에 액션 메소드 `${`lineSwitcherApi}`를 입력하면 상담원 연결 설정이 완료됩니다. ![chatbot-chatbot-6-1_cs02_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-6-1_cs02_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A06%3A31Z&se=2026-10-26T22%3A06%3A31Z&sr=c&sp=r&sig=jhtpRoRjhMUu1%2BGhKZLCJuWLSovb7fI85d2PyaDnWH8%3D)