Messenger Integration Account Properties
Bright Pattern Contact Center integrates with all major social messaging applications (i.e., messengers), including Facebook Messenger, LINE, Telegram, Twitter, Viber, WeChat, and WhatsApp (via Infobip, Twilio, or Vonage API Group/Nexmo), allowing Agent Desktop users to handle service chat interactions over any configured messenger channel. In the Bright Pattern platform, we use messenger integration accounts to store credentials and allow connections between Bright Pattern and your organization's messaging app accounts and/or developer portals.
This article describes the only properties for every type of messenger integration account. For complete integration configuration instructions and administrative tutorials, see the Messenger Integration Guide.
How to Add a Messenger Integration Account
To add a messenger integration account to your contact center, go to the Contact Center Administrator application's Call Center Configuration > Integration Accounts section.
Click the add "+" button and select the desired type of messaging application to add.
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 Messenger Integration Guide, section Facebook Messenger Integration.
Name
The name for this integration account (can be any name of your choosing).
Page Username
The @username of the Facebook Page (e.g., “brightpatterndocs” with no @ symbol).
Type
The messenger integration count type. Select Facebook for Facebook Messenger.
Page ID
The Facebook Page ID (string), which can be found in the "About" section of the Facebook Page.
Token
The Page Access Token for the 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.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
Generate random token
Creates a random webhook token that you can copy and paste into your Facebook App in section Messenger Settings > Webhooks > Edit Callback URL > 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 Messenger Integration Guide, section LINE Integration.
Name
The name of your integration account (this does not need to be your LINE@ account name).
Type
The integration account type. For LINE accounts, select LINE.
Token
The access token for your LINE account.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
Test Connection
Tests the credentials and confirms whether the connection is valid.
MS Teams
The properties of the Microsoft Teams messenger integration account are described below. For complete integration instructions and configuration, see the Messenger Integration Guide section Microsoft Teams Messenger Integration.
Name
The name for this integration account, which will identify it within Bright Pattern Contact Center.
App ID
Provide the Bot ID that was automatically generated while creating an app for Microsoft Teams for the integration.
App Secret
Provide the Client Secret that was generated while creating an app for Microsoft Teams for the integration.
Account ID
The unique identifier of this integration account, which is automatically generated when the integration account is created.
Endpoint Address
A note provides the URL that must be provided in the Endpoint Address property when configuring an app for Microsoft Teams to use this messenger integration account.
Test Connection
Tests whether the App ID and App Secret are valid and allow a connection through the messenger integration.
Telegram Properties
The properties of the Telegram type of messenger integration account are described as follows. For complete integration instructions and configuration, see the Messenger Integration Guide, section Telegram Integration.
Bot Username
The exact username of your Telegram bot.
Type
The integration account type. For Telegram accounts, select Telegram.
Token
The API token for your Telegram bot.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
Set Webhook
Click this 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.
Twitter v2 Properties
The properties of the Twitter type integration account are described as follows. For complete integration instructions and configuration, see the Messenger Integration Guide, section Twitter Integration
Name
The name of your integration account (can be any name of your choosing).
Consumer Key
Your Twitter app's API key.
Consumer Secret
Your Twitter app's API secret key.
Access Token
Your Twitter app's access token.
Access Token Secret
Your Twitter app's access token secret.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
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 Messenger Integration Guide, section Viber Integration.
Bot Username
The exact username of your Viber Bot Account.
Type
The integration account type. For Viber accounts, select Viber.
Token
The private token of your Viber Bot Account.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
Set Webhook
Setting the webhook is necessary for Viber to send you a message from the customer. Click Set Webhook to open enter the webhook URL.
Webhook url (host and port)
Your contact center domain (e.g., “company.brightpattern.com”). This includes the server address and port number.
Test Connection
Tests the credentials and confirms whether the connection is valid.
WeChat Properties
The properties of the WeChat type of integration account are described as follows. For complete integration instructions and configuration, see the Messenger Integration Guide, section WeChat Integration.
Name
The name of your integration account (can be any name of your choosing)
Type
The integration account type. For WeChat accounts, select WeChat.
App ID
The appId of your WeChat sandbox, which is found on the Test number management page.
App Secret
The app secret of your WeChat sandbox, which is found on the Test number management page.
WeChat ID
The identifying string for your WeChat account, which is found in the top right corner of your WeChat sandbox Test number management page.
WeChat type
The type of WeChat official account. Set “China” if the region of your WeChat official account is China, or “International” if the region of your WeChat official account is not China.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.
Test Connection
Tests the credentials and confirms whether the connection is valid.
WhatsApp Properties
Bright Pattern Contact Center integrates with WhatsApp via the following service providers: Infobip, Twilio, and Vonage API Group/Nexmo. When configuring a messenger integration account for WhatsApp, select either Infobip, Twilio, or Vonage API Group/Nexmo. The integration account properties for each provider type are provided as follows.
Infobip
For complete integration configuration instructions, see the Messenger Integration Guide, section WhatsApp via Infobip Integration.
Name
The name of your integration account (can be any name of your choosing).
Type
Provider
Infobip
API URL
The Base URL obtained from Infobip (e.g., “https://gnpq8.api.infobip.com”)
API Key
Your Infobip Public API key.
WhatsApp number
The dedicated WhatsApp number obtained from Infobip (e.g., 12012345678)
Account ID
The unique identifier of this integration account, which is appended to the end of the webhook URL in the Infobip portal. The Account ID is generated when you click Apply at the bottom of the screen.
Twilio
For complete integration configuration instructions, see the Messenger Integration Guide, section WhatsApp via Twilio Integration.
Name
The name of your integration account (can be any name of your choosing)
Type
Provider
Twilio
API URL
https://api.twilio.com/2010-04-01/
SID
The SID obtained from Twilio WhatsApp Sandbox credentials
Token
The token obtained from Twilio WhatsApp Sandbox credentials
WhatsApp number
The WhatsApp number provided by Twilio (e.g., +XXXXXXXX)
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply
Nexmo
For complete integration configuration instructions, see the Messenger Integration Guide, section Vonage API Group/Nexmo Integration.
Name
The name of your integration account (can be any name of your choosing)
Type
Provider
Nexmo
API URL
https://api.nexmo.com/v0.1/messages
Authentication type
Set JWT and then set the actual JWT.
Key
The JWT authentication key from the Vonage API Group sandbox account
Secret
For a sandbox environment, leave this field empty.
WhatsApp number
The Nexmo (Vonage API Group) Customer Dashboard number (e.g., “123418342149”). This number is shown on the top right of the Nexmo (Vonage API Group) sandbox account after login.
Account ID
The unique identifier of this integration account, which is filled in for you upon clicking Apply.