LINE Switcher API integrations

Available in Classic and VPC

The LINE Switcher API is an agent-connection API supported by the LINE Messenger channel. Using the LINE Switcher APIs, you can design conversations that route users to a live agent. The integration works properly only when all requirements for agent connection are configured in the LINE Messenger environment.

Before integrating with the LINE Switcher APIs, complete the following prerequisites.

• Create API Gateway Invoke URL
• Create a LINE Business account
• Check the information required for LINE Switcher APIs integration
  • CLOVA Chatbot Switcher secret information
  • Operation Agent Destination ID

After integrating with the LINE Switcher APIs, complete the following tasks.

• Create conversations for agent connection

LINE Switcher API integrations

To integrate the LINE Switcher APIs:

1. Access LINE Business Center.
2. Click the account name.
   • Go to the management page for the selected account.
3. Click [Setting] in the upper-right corner of the interface.
4. Click Setting > Messaging APIs > [Enable Messaging APIs].
5. When the Developer Information Registration window appears, enter the developer information and click [Agree].
6. Enter the operations manager information and click [Agree].

Check information required for LINE Switcher APIs integration

To check the Switcher secret and Destination ID in the Switcher APIs tab on LINE Developers:

1. Access LINE Developers.
2. Click [Console] then click the account name.
3. In the Switcher APIs tab, click [Add].
   • The Switcher APIs tab is available only for corporate accounts that have contracted LINE and the Switcher APIs.
     
4. Enter the Destination Name and Webhook URL for CLOVA Chatbot, then create it.
5. Copy the Switcher Secret information and save it.
6. Enter the Destination Name and Webhook URL for the Operation Agent, then create it.
7. Copy the Destination ID information and save it.

Configure LINE Switcher APIs integration in the Chatbot Builder

To integrate the chatbot with the LINE Switcher APIs in the Chatbot Builder:

1. Complete the preliminary tasks.
   • API Gateway integration
   • Check information required for integration.
2. In the NAVER Cloud Platform console, navigate to > Services > AI Services > CLOVA Chatbot > Domain.
3. Click [Run builder] of the domain you want to run the Chatbot Builder.
4. In the Chatbot Builder, click Chatbot Setting > [Service Integration] tab.
5. Click [Integrate] of LINE Switcher APIs
6. In the service integration window, enter the Switcher secret and Destination ID.
   • To check the required input values, see Checking the required information for LINE Switcher APIs integration.
7. Enter the message to send when the agent connection fails.
8. Click [Integrate].

Create an agent connection conversation

• Once LINE Switcher APIs integration is complete, you can edit the agent-connection action method ${`lineSwitcherApi}appears in the action method menu. When editing the action method ${`lineSwitcherApi} you can define up to 10 notes to deliver together with the APIs request. For example, if you register ${'lineSwitcherApi(shopping)}, you can pass the string "Shopping" to the APIs so that an agent assigned to the Shopping category responds.
  

• When creating a conversation, enter the action method ${`lineSwitcherApi}in the response of the conversation where you want to connect to an agent. This completes the agent connection setup.