(Marked this version for translation) |
|||
Line 1: | Line 1: | ||
− | <translate>= Messenger Integration = | + | <translate>= Messenger Integration = <!--T:1--> |
When Bright Pattern Contact Center is integrated with messengers (e.g., Facebook Messenger, LINE, Telegram, Viber, etc.), your Bright Pattern Agent Desktop environment is equipped to handle customer-initiated interactions from the Messenger application or the application on a customer’s mobile phone, tablet, or computer. Incoming chat interactions are routed to the integrated Agent Desktop environment, where agents also have direct access to the phone, live chat, email, SMS text, various other mobile messenger apps, customer and agent records, interaction details, and more. | When Bright Pattern Contact Center is integrated with messengers (e.g., Facebook Messenger, LINE, Telegram, Viber, etc.), your Bright Pattern Agent Desktop environment is equipped to handle customer-initiated interactions from the Messenger application or the application on a customer’s mobile phone, tablet, or computer. Incoming chat interactions are routed to the integrated Agent Desktop environment, where agents also have direct access to the phone, live chat, email, SMS text, various other mobile messenger apps, customer and agent records, interaction details, and more. | ||
Integration configuration involves linking your organization's messenger account to your Bright Pattern Contact Center tenant. | Integration configuration involves linking your organization's messenger account to your Bright Pattern Contact Center tenant. | ||
+ | <!--T:2--> | ||
To add a messenger integration account, click the '''add''' "+" button and select the desired type of messenger. | To add a messenger integration account, click the '''add''' "+" button and select the desired type of messenger. | ||
+ | <!--T:3--> | ||
[[File:Messenger-Type-50.png|450px|thumbnail|center|Selecting the type of Messenger integration account]] | [[File:Messenger-Type-50.png|450px|thumbnail|center|Selecting the type of Messenger integration account]] | ||
+ | <!--T:4--> | ||
The properties of each type of messenger integration account are described as follows. For more information about each type, see the corresponding integration guide. | The properties of each type of messenger integration account are described as follows. For more information about each type, see the corresponding integration guide. | ||
− | == Facebook Messenger Properties == | + | == Facebook Messenger Properties == <!--T:5--> |
The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the [[facebook-messenger-integration-guide/About|Facebook Messenger Integration Guide]]. | The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the [[facebook-messenger-integration-guide/About|Facebook Messenger Integration Guide]]. | ||
+ | <!--T:6--> | ||
[[File:Facebook-Messenger-Properties-50.png|450px|thumbnail|center|Facebook Messenger integration account properties]] | [[File:Facebook-Messenger-Properties-50.png|450px|thumbnail|center|Facebook Messenger integration account properties]] | ||
− | === Page Username === | + | === Page Username === <!--T:7--> |
The exact username of your Facebook Page | The exact username of your Facebook Page | ||
− | === Type === | + | === Type === <!--T:8--> |
Select Facebook as the ''type'' of messenger integration account. | Select Facebook as the ''type'' of messenger integration account. | ||
− | === Page ID === | + | === Page ID === <!--T:9--> |
The exact page ID for your Facebook Page | The exact page ID for your Facebook Page | ||
− | === Token === | + | === Token === <!--T:10--> |
The Page Access Token for your Facebook Page | The Page Access Token for your Facebook Page | ||
− | === Webhook Verify Token === | + | === Webhook Verify Token === <!--T:11--> |
The token used to confirm that Facebook is the real server, which is needed for Facebook to send you a message from the customer. If you do not have a token, click the Generate random token below. | The token used to confirm that Facebook is the real server, which is needed for Facebook to send you a message from the customer. If you do not have a token, click the Generate random token below. | ||
− | === Generate random token === | + | === Generate random token === <!--T:12--> |
Creates a random webhook token that you can copy and paste into your Facebook App management page in ''Webhooks > Edit Page Subscription > Verify Token'' | Creates a random webhook token that you can copy and paste into your Facebook App management page in ''Webhooks > Edit Page Subscription > Verify Token'' | ||
− | === Test Connection === | + | === Test Connection === <!--T:13--> |
Tests the credentials and confirms whether the connection is valid | Tests the credentials and confirms whether the connection is valid | ||
− | == LINE Properties == | + | == LINE Properties == <!--T:14--> |
The properties of the LINE type of integration account are described as follows. For complete integration instructions and configuration, see the [[line-integration-guide/About|LINE Integration Guide]]. | The properties of the LINE type of integration account are described as follows. For complete integration instructions and configuration, see the [[line-integration-guide/About|LINE Integration Guide]]. | ||
+ | <!--T:15--> | ||
[[File:LINE-Properties-50.png|450px|thumbnail|center|LINE integration account properties]] | [[File:LINE-Properties-50.png|450px|thumbnail|center|LINE integration account properties]] | ||
− | === Name === | + | === Name === <!--T:16--> |
The name of your integration account (this does not need to be your LINE@ account name) | The name of your integration account (this does not need to be your LINE@ account name) | ||
− | === Type === | + | === Type === <!--T:17--> |
For this integration account, select LINE as the ''type'' of integration. | For this integration account, select LINE as the ''type'' of integration. | ||
− | === Token === | + | === Token === <!--T:18--> |
The access token for your LINE@ account | The access token for your LINE@ account | ||
− | === Test Connection === | + | === Test Connection === <!--T:19--> |
Tests the credentials and confirms whether the connection is valid | Tests the credentials and confirms whether the connection is valid | ||
− | == Nexmo Properties == | + | == Nexmo Properties == <!--T:20--> |
The properties of the Nexmo type of integration account are described as follows. | The properties of the Nexmo type of integration account are described as follows. | ||
+ | <!--T:21--> | ||
[[File:Nexmo-Properties-53.PNG|450px|thumbnail|center|Nexmo integration account properties]] | [[File:Nexmo-Properties-53.PNG|450px|thumbnail|center|Nexmo integration account properties]] | ||
− | === Name === | + | === Name === <!--T:22--> |
The name of your integration account (can be any name of your choosing) | The name of your integration account (can be any name of your choosing) | ||
− | === Type === | + | === Type === <!--T:23--> |
"Nexmo" by default because you already selected this type of messenger integration account | "Nexmo" by default because you already selected this type of messenger integration account | ||
− | === Key === | + | === Key === <!--T:24--> |
The API key that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings. | The API key that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings. | ||
− | === Secret === | + | === Secret === <!--T:25--> |
The API secret that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings. | The API secret that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings. | ||
− | == Telegram Properties == | + | == Telegram Properties == <!--T:26--> |
The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the [[telegram-integration-guide/About|Telegram Integration Guide]]. | The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the [[telegram-integration-guide/About|Telegram Integration Guide]]. | ||
+ | <!--T:27--> | ||
[[File:Telegram-Properties-50.png|450px|thumbnail|center|Telegram messenger integration account properties]] | [[File:Telegram-Properties-50.png|450px|thumbnail|center|Telegram messenger integration account properties]] | ||
− | === Bot Username === | + | === Bot Username === <!--T:28--> |
The exact username of your Telegram bot | The exact username of your Telegram bot | ||
− | === Type === | + | === Type === <!--T:29--> |
For this integration account, select Telegram as the ''type'' of integration. | For this integration account, select Telegram as the ''type'' of integration. | ||
− | === Token === | + | === Token === <!--T:30--> |
The API token for your Telegram bot | The API token for your Telegram bot | ||
− | === Set Webhook === | + | === Set Webhook === <!--T:31--> |
Click the ''Set Webhook'' button to confirm that Telegram is the real server, which is needed for Telegram to send you a message from the customer. Note that you must get the token/webhook from Telegram; you cannot generate one here. | Click the ''Set Webhook'' button to confirm that Telegram is the real server, which is needed for Telegram to send you a message from the customer. Note that you must get the token/webhook from Telegram; you cannot generate one here. | ||
− | === Test Connection === | + | === Test Connection === <!--T:32--> |
Tests the credentials and confirms whether the connection is valid | Tests the credentials and confirms whether the connection is valid | ||
− | == Viber Properties == | + | == Viber Properties == <!--T:33--> |
The properties of the Viber type of integration account are described as follows. For complete integration instructions and configuration, see the [[viber-integration-guide/About|Viber Integration Guide]]. | The properties of the Viber type of integration account are described as follows. For complete integration instructions and configuration, see the [[viber-integration-guide/About|Viber Integration Guide]]. | ||
+ | <!--T:34--> | ||
[[File:Viber-Properties-50.png|450px|thumbnail|center|Viber messenger integration account properties]] | [[File:Viber-Properties-50.png|450px|thumbnail|center|Viber messenger integration account properties]] | ||
− | === Bot Username === | + | === Bot Username === <!--T:35--> |
The exact name of your Viber Public Account username. | The exact name of your Viber Public Account username. | ||
− | === Type === | + | === Type === <!--T:36--> |
For this integration account, select Viber as the ''type'' of integration. | For this integration account, select Viber as the ''type'' of integration. | ||
− | === Token === | + | === Token === <!--T:37--> |
The password that is given to you after your Public Account application is approved | The password that is given to you after your Public Account application is approved | ||
− | === Set Webhook === | + | === Set Webhook === <!--T:38--> |
''Set Webhook'' is necessary for Viber to send you a message from the customer. Clicking the ''Set Webhook'' button opens the Set Webhook window, where the Webhook URL is entered. | ''Set Webhook'' is necessary for Viber to send you a message from the customer. Clicking the ''Set Webhook'' button opens the Set Webhook window, where the Webhook URL is entered. | ||
− | === Webhook url (host and port) === | + | === Webhook url (host and port) === <!--T:39--> |
The address of your server and port number (e.g., “office.yourcompany.com:1234”). If you do not know the server URL or port number, ask your system administrator. | The address of your server and port number (e.g., “office.yourcompany.com:1234”). If you do not know the server URL or port number, ask your system administrator. | ||
− | === Test Connection === | + | === Test Connection === <!--T:40--> |
Tests the credentials and confirms whether the connection is valid. | Tests the credentials and confirms whether the connection is valid. | ||
Revision as of 04:28, 25 June 2020
<translate>= Messenger Integration = When Bright Pattern Contact Center is integrated with messengers (e.g., Facebook Messenger, LINE, Telegram, Viber, etc.), your Bright Pattern Agent Desktop environment is equipped to handle customer-initiated interactions from the Messenger application or the application on a customer’s mobile phone, tablet, or computer. Incoming chat interactions are routed to the integrated Agent Desktop environment, where agents also have direct access to the phone, live chat, email, SMS text, various other mobile messenger apps, customer and agent records, interaction details, and more. Integration configuration involves linking your organization's messenger account to your Bright Pattern Contact Center tenant.
To add a messenger integration account, click the add "+" button and select the desired type of messenger.
The properties of each type of messenger integration account are described as follows. For more information about each type, see the corresponding integration guide.
Facebook Messenger Properties
The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the Facebook Messenger Integration Guide.
Page Username
The exact username of your Facebook Page
Type
Select Facebook as the type of messenger integration account.
Page ID
The exact page ID for your Facebook Page
Token
The Page Access Token for your Facebook Page
Webhook Verify Token
The token used to confirm that Facebook is the real server, which is needed for Facebook to send you a message from the customer. If you do not have a token, click the Generate random token below.
Generate random token
Creates a random webhook token that you can copy and paste into your Facebook App management page in Webhooks > Edit Page Subscription > Verify Token
Test Connection
Tests the credentials and confirms whether the connection is valid
LINE Properties
The properties of the LINE type of integration account are described as follows. For complete integration instructions and configuration, see the LINE Integration Guide.
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
Tests the credentials and confirms whether the connection is valid
Nexmo Properties
The properties of the Nexmo type of integration account are described as follows.
Name
The name of your integration account (can be any name of your choosing)
Type
"Nexmo" by default because you already selected this type of messenger integration account
Key
The API key that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings.
Secret
The API secret that was created when you created a Nexmo account. You can find the API key and secret in your Nexmo Dashboard account settings.
Telegram Properties
The properties of the Facebook Messenger type of integration account are described as follows. For complete integration instructions and configuration, see the Telegram Integration Guide.
Bot Username
The exact username of your Telegram bot
Type
For this integration account, select Telegram as the type of integration.
Token
The API token for your Telegram bot
Set Webhook
Click the Set Webhook button to confirm that Telegram is the real server, which is needed for Telegram to send you a message from the customer. Note that you must get the token/webhook from Telegram; you cannot generate one here.
Test Connection
Tests the credentials and confirms whether the connection is valid
Viber Properties
The properties of the Viber type of integration account are described as follows. For complete integration instructions and configuration, see the Viber Integration Guide.
Bot Username
The exact name of your Viber Public Account username.
Type
For this integration account, select Viber as the type of integration.
Token
The password that is given to you after your Public Account application is approved
Set Webhook
Set Webhook is necessary for Viber to send you a message from the customer. Clicking the Set Webhook button opens the Set Webhook window, where the Webhook URL is entered.
Webhook url (host and port)
The address of your server and port number (e.g., “office.yourcompany.com:1234”). If you do not know the server URL or port number, ask your system administrator.
Test Connection
Tests the credentials and confirms whether the connection is valid.
</translate>