Linking with LINE Switcher API

Available in Classic and VPC

LINE Switcher API is an agent linking API, which is a feature supported by the LINE messenger channel. You can use LINE Switcher API to create conversations designed to connect the user with an agent. It works only properly when the matters required for an agent connection are prepared on the LINE messenger environment.

The following tasks need be performed before setting up linkage with LINE Switcher API.

• Create API Gateway invoke URL
• Create LINE business account
• Check required information for linking with LINE Switcher API
  • CLOVA Chatbot's Switcher secret information
  • Operation agent's destination ID

The following tasks need be performed after setting up linkage with LINE Switcher API.

• Create a conversation for agent connection

Linking with LINE Switcher API

The following describes how to set up linkage with LINE Switcher API.

1. Connect to LINE business center.
2. Click the account name.
   • Go to the account's management page.
3. Click [Settings] at the top right of the page.
4. Click Settings > Messaging API > [Turn on messaging API] button.
5. When the developer information registration window appears, enter the developer information, and then click the [Agree] button.
6. Enter the operation staff in charge, and then click the [Agree] button.

Check required information for linking with LINE Switcher API

The following describes how to view the Switcher secret and destination ID information from the Switcher API tab of LINE Developers.

1. Access LINE Developers (https://developers.line.biz/en/).
2. Click the [Console] button, and then click the account name.
3. Under the Switcher API tab, click the [Add] button.
   • The Switcher API tab is only enabled if you are a corporation that has a Switcher API contract with LINE.
     
4. Enter and create the destination name and webhook URL for CLOVA Chatbot.
5. Copy and save the Switcher secret information.
6. Enter and create the destination name and webhook URL for the operation agent.
7. Copy and save the destination ID information.

LINE Switcher API linkage settings in chatbot builder

The following describes how to set up linkage between the chatbot and LINE Switcher API in the chatbot builder.

1. Complete the preliminary preparation.
   • Link API Gateway
   • Check required information for linkage
2. From the NAVER Cloud Platform console, click the Services > CLOVA Chatbot > Domain menus, in that order.
3. Click the [Run builder] button of the domain you want to run the chatbot builder.
4. From the chatbot builder, click Chatbot settings > Link service tab.
5. Under the LINE Switcher API tab, click the [Link] button.
6. In the Link service window, enter the Switcher secret and destination ID.
   • For how to check the values to enter, refer to Check required information for linking with LINE Switcher API.
7. Enter the message to be sent when agent connection fails.
8. Click the [Link] button.

Create agent connection conversation

• The action method of ${'lineSwitcherApi} for agent connection is displayed on the Action method menu once the LINE Switcher API is linked. You may write up to 10 notes that can be sent with the API by modifying the action method of {'lineSwitcherApi(shopping)}` will send the "Shopping" string to the API for the Shopping category agent to respond.
  

• When creating a conversation, enter the action method of ${'lineSwitcherApi} in the answer of the conversation for which agent connection is desired to complete agent connection settings.