From Bright Pattern Documentation
Jump to: navigation, search
m (Reverted edits by Ivan (talk) to last revision by Elizabeth)
Tag: Rollback
Line 1: Line 1:
−
<translate>= LINE Integration Configuration Overview =
+
<translate>= Integration Configuration= <!--T:1-->
−
This section details the steps required to integrate your Bright Pattern Contact Center with the LINE messenger for the purpose of allowing your agents to directly message LINE users, and vice versa.
+
== Step 1: Sign in to your business’s LINE@ account and enable the Messaging API. ==
 +
To use LINE as a business, you must have a registered LINE@ account.
 +
 
 +
<!--T:2-->
 +
# Navigate to the [https://developers.line.biz/ LINE Developers page] and view your LINE@ account page.
 +
# At the bottom of the page, select the '''Start using Messaging API''' button, agree to the terms and conditions, and click '''OK'''.
 +
# At the bottom of the confirmation page, click the '''LINE@ MANAGER''' button, which will take you to to the the LINE@ Manager Bot Settings page.
 +
# On the ''Bot Settings'' page, click '''Enable API'''.
 +
 
 +
 
 +
== Step 2: Allow webhooks. == <!--T:5-->
 +
After your LINE@ account has the Messaging API enabled, you will need to enable webhooks. Enabling webhooks for your LINE@ account on the LINE@ Manager allows you to receive messages from LINE users.
 +
# From the [http://admin-official.line.me/ LINE@ Manager] side menu, navigate to ''Settings > Bot Settings''.
 +
# Under ''Request Settings'', select '''Allow''' for “Use webhooks.” Selecting this is important because it lets you receive messages from LINE users.
 +
 
 +
<!--T:6-->
 +
LINE provides the following optional settings:
 +
* ''Allow bots to join group chats:'' Bright Pattern LINE integration does not currently support group chats. Note that selecting '''Allow''' will not enable bots to group chats.
 +
* ''Auto Reply Message:'' This option should be removed or set to '''Don’t allow''' so that LINE users will receive only chat messages from the integration account scenario.
 +
* ''Greeting Message:'' This option should be removed or set to '''Don’t allow''' so that the customized greeting message that is sent to LINE users is set in the scenario only.
 +
 
 +
 
 +
== Step 3: Get a Channel access token and set a webhook URL on the Channel Console. == <!--T:7-->
 +
Your bot application requires a Channel access token to call APIs, along with a webhook URL to receive webhook payloads. Channel access tokens are issued from LINE’s Channel Console. The webhook URL is the endpoint of your bot application’s server where webhook payloads are sent.
 +
 
 +
<!--T:8-->
 +
# In the [https://business.line.me/ LINE Business Center], go to your LINE@ account page.
 +
# In the Messaging API section, select the '''LINE Developers''' button to go to the Channel Console.
 +
# To issue a Channel access token for accessing APIs, click '''ISSUE''' for the “Channel access token” item.
 +
# Click '''EDIT''' and set a webhook URL for your Channel.
 +
 
 +
 
 +
<!--T:9-->
 +
Note the following:
 +
For troubleshooting purposes, you should verify that the webhook is set properly by using the '''Verify''' button. (See Step 5 of this procedure, after the integration account is added.)
 +
 
 +
<!--T:10-->
 +
The webhook URL must refer to the BP client web server used by the contact center in the following form:
 +
 
 +
<!--T:11-->
 +
''https://<host name>/clientweb/line/webhook/<url-encoded access token>''
 +
 
 +
<!--T:12-->
 +
The host name is the host name of the BP client web server used by your contact center.
 +
 
 +
== Step 4: Create a new integration account in Contact Center Administrator. == <!--T:13-->
 +
# Log in as Admin to the Contact Center Administrator application.
 +
# Navigate to ''Configuration > Integration Accounts''.
 +
# Click the '''Add''' "+" button to add a new account.
 +
# In the ''Create integration account'' window that appears, select '''Messenger''' and click '''OK'''.
 +
 
 +
 
 +
<!--T:14-->
 +
[[File:Create-Messenger-Integration-Account-50.png|450px|thumbnail|center|Create a new Messenger integration account]]
 +
 
 +
 
 +
== Step 5: Specify LINE integration account properties. == <!--T:15-->
 +
Using the credentials for your LINE@ account, enter values for the following screen properties. (If you do not know your credentials, ask your system administrator.)
 +
* '''Name''' - The name of your integration account (this does not need to be your LINE@ account name)
 +
* '''Type''' - For this integration account, select LINE as the type of integration.
 +
* '''Token''' - The access token for your LINE@ account
 +
* '''Test Connection''' - This button tests the credentials and confirms whether the connection is valid.
 +
 
 +
<!--T:16-->
 +
Click '''Apply''' to save your changes.
 +
 
 +
 
 +
<!--T:17-->
 +
[[File:Line-Integration-Properties-50.png|450px|thumbnail|center|LINE integration account properties]]
 +
 
 +
 
 +
<!--T:18-->
 +
Your integration account is now configured for LINE. Next, you can do a real test of your connection by setting up a messenger chat scenario and responding to chat interactions from within the Agent Desktop application.
  
−
== Integration Configuration Steps ==
 
−
# [[Messenger-integration-guide/LINE/ConfigurationCreateMessagingAPI|Create a Messaging API Channel for LINE Integration]]
 
−
# [[Messenger-integration-guide/LINE/ConfigurationAccessTokenWebhook | Get LINE Channel Access Token and Webhook]]
 
−
# [[Messenger-integration-guide/LINE/ConfigurationIntegrationAccount | Create a Messenger Integration Account for LINE]]
 
−
# [[Messenger-integration-guide/LINE/ConfigurationScenarioEntryandService | Assign LINE Integration to a Service and Scenario Entry]]
 
−
# [[Messenger-integration-guide/LINE/ConfigurationUsingLINE | Using LINE on Agent Desktop]]
 
−
 
  
−
[[File:LINE-Chat-5399maint.PNG|800px|thumb|center|An agent chatting with a customer via LINE]]
 
  
  

Revision as of 22:27, 15 September 2023

• 日本語
• 5.19 • 5.2 • 5.3 • 5.8

<translate>= Integration Configuration=

Step 1: Sign in to your business’s LINE@ account and enable the Messaging API.

To use LINE as a business, you must have a registered LINE@ account.

  1. Navigate to the LINE Developers page and view your LINE@ account page.
  2. At the bottom of the page, select the Start using Messaging API button, agree to the terms and conditions, and click OK.
  3. At the bottom of the confirmation page, click the LINE@ MANAGER button, which will take you to to the the LINE@ Manager Bot Settings page.
  4. On the Bot Settings page, click Enable API.


Step 2: Allow webhooks.

After your LINE@ account has the Messaging API enabled, you will need to enable webhooks. Enabling webhooks for your LINE@ account on the LINE@ Manager allows you to receive messages from LINE users.

  1. From the LINE@ Manager side menu, navigate to Settings > Bot Settings.
  2. Under Request Settings, select Allow for “Use webhooks.” Selecting this is important because it lets you receive messages from LINE users.

LINE provides the following optional settings:

  • Allow bots to join group chats: Bright Pattern LINE integration does not currently support group chats. Note that selecting Allow will not enable bots to group chats.
  • Auto Reply Message: This option should be removed or set to Don’t allow so that LINE users will receive only chat messages from the integration account scenario.
  • Greeting Message: This option should be removed or set to Don’t allow so that the customized greeting message that is sent to LINE users is set in the scenario only.


Step 3: Get a Channel access token and set a webhook URL on the Channel Console.

Your bot application requires a Channel access token to call APIs, along with a webhook URL to receive webhook payloads. Channel access tokens are issued from LINE’s Channel Console. The webhook URL is the endpoint of your bot application’s server where webhook payloads are sent.

  1. In the LINE Business Center, go to your LINE@ account page.
  2. In the Messaging API section, select the LINE Developers button to go to the Channel Console.
  3. To issue a Channel access token for accessing APIs, click ISSUE for the “Channel access token” item.
  4. Click EDIT and set a webhook URL for your Channel.


Note the following: For troubleshooting purposes, you should verify that the webhook is set properly by using the Verify button. (See Step 5 of this procedure, after the integration account is added.)

The webhook URL must refer to the BP client web server used by the contact center in the following form:

https://<host name>/clientweb/line/webhook/<url-encoded access token>

The host name is the host name of the BP client web server used by your contact center.

Step 4: Create a new integration account in Contact Center Administrator.

  1. Log in as Admin to the Contact Center Administrator application.
  2. Navigate to Configuration > Integration Accounts.
  3. Click the Add "+" button to add a new account.
  4. In the Create integration account window that appears, select Messenger and click OK.


Create a new Messenger integration account


Step 5: Specify LINE integration account properties.

Using the credentials for your LINE@ account, enter values for the following screen properties. (If you do not know your credentials, ask your system administrator.)

  • Name - The name of your integration account (this does not need to be your LINE@ account name)
  • Type - For this integration account, select LINE as the type of integration.
  • Token - The access token for your LINE@ account
  • Test Connection - This button tests the credentials and confirms whether the connection is valid.

Click Apply to save your changes.


LINE integration account properties


Your integration account is now configured for LINE. Next, you can do a real test of your connection by setting up a messenger chat scenario and responding to chat interactions from within the Agent Desktop application.




</translate>

< Previous | Next >
Retrieved from "https://help.brightpattern.com/index.php?title=5.19:Line-integration-guide/IntegrationConfiguration&oldid=141492"