How to Integrate Instagram to Tegsoft Web Chat?
  • 19 Jul 2022
  • 3 Minutes to read
  • Dark
    Light

How to Integrate Instagram to Tegsoft Web Chat?

  • Dark
    Light

Article Summary

Instagram's messenger function is called Instagram Direct and allows users to chat with businesses.

Tegsoft provides the opportunity to integrate Instagram Direct Messenger into their products. This integration enables users to manage, record, process and report inbound customer conversations emerging from Instagram Messenger as Tegsoft web chat calls without the need to transfer call data from third parties.

This article describes how to integrate Instagram Direct Message to the Tegsoft Web Chat.

Instagram Messenger Activation Steps

Please, follow the steps below to integrate Instagram Direct Messenger to Tegsoft Web Chat.

1. Facebook Business Manager Activation

First, you need to activate Facebook Business Manager account which is the provider of Instagram Direct Message. Therefore, please create an account from Facebook Business Manager by following the steps in flowchart below.
0001.jpg

2. Instagram Messenger Activation

Please, follow the steps below to activate Instagram Messenger account.

Note: Before you begin, make sure that you are the admin of the page to be integrated.


1.  ➤ Go to https://developers.facebook.com/ and login to your account.
➤ Click My Apps.
Screen Shot 2021-12-30 at 11.34.34.png


2.  ➤ Click Create App button in the top right-hand corner.
1.png


3.  ➤ Select Business app type. (The app type cannot be changed after your app is created.)
➤ Click Next.
2.png


4.  ➤ Enter a Display name for your app.
     (This is the app name associated with your app ID. You can change this later.)
➤ Enter an App Contact Email address for your app.
     (This email address is used to contact you about potential policy violations, app restrictions or steps to recover the app if it’s been deleted or compromised.)
➤ Select the Business Account from the list.
     (To access certain permission of features, apps need to be connected to a Business Account.)
➤ Click Create App.
3.png


5. After creating app successfully;
➤ Click Set Up Messenger to customize the way you interact with people on Instagram Messenger.


6. After setting up Messenger;
➤ Click Messenger and then Settings.
➤ Click Add or Remove Pages.


7. After adding new page;
➤ Click Generate Token.
➤ Copy generated Token and keep it for future use.
➤ Click Done.
7.png


8. After the Instagram Messenger activation is completed successfully, integration parameters shall be set in Tegsoft software.
Follow the steps below in Tegsoft software to set integration parameters.
Step 1 – Click CC Management tab.
Step 2 – Click Contact Center Settings tab.
Step 3 – Click plus icon (+) to add new integration parameters.
Step 4 – Set parameters.
Step 5 – Click the Save button.

The parameters in Step 4 are described in the table below.

ParameterDescription
Account NameEnter an account name.
Account TypeSelect account type as Instagram from the list.
URLEnter the URL as https://graph.facebook.com/v13.0.
API keyEnter your Token generated from Facebook for Developers.
UsernameNULL
PasswordNULL
Phone NumberNULL
Is activeClick checkbox as active.
NotesType your notes.
Account idThis is your TRUNKID parameter value in the CallbackURL. Copy and keep it.
⚠️  IMPORTANT NOTICE
The Account ID in the integration parameters will be used as the value of the TRUNKID parameter in the Callback URL in the activation steps on the Facebook for Developers screens. Please keep this Account ID for future use in the next step.


9. After generating token;
➤ Click Add Callback URL.
➤ Enter your Callback URL.
(Validation requests and Webhook notifications for this object will be sent to this URL.)
➤ Enter your Verify Token.
(Token that Facebook will echo back to you as part of callback URL verification.)

Callback URL is:
https://{{YOUR_DOMAIN}}/Tobe/app/ApplicationServlet?externalService=textRouter&TRUNKTYPE=INSTAGRAM&TRUNKID=ACCOUNTID

Verify Token is:
tegsoft123

Note: In Callback URL, TRUNKTYPE and TRUNKID parameters are mandatory.

    ➤ Click Verify and Save.

8.png


10. After adding Callback URL;
➤ Click Webhooks.
➤ Select Instagram.
➤ Select messages subscription.


11.After subscribing to the messages webhook;
➤ Click App Review.
➤ Click Permissions and Features.
➤ Filter pages_messaging.
➤ Click Request advanced access for pages_messages permission.

➤ Filter instagram_manage_messages.
➤ Click Request advanced access for instagram_manage_messages permission.


12.After adding the above two permissions and features;
➤ Click Requests.
➤ Click Edit.

 

13. After clicking the edit button, you will see the following page. In this page, you need to complete all steps of app settings and submit your settings for review. App review process takes approximately 5 days. If your requests are approved, you can proceed to the next step. If your requests are not approved, please edit your requests again, taking into account the feedbacks sent by the facebook team.


14. After all settings are configured and activations steps are completed successfully, web chat skill shall be created using the related number.

For detailed information about creating a web chat skill, please check out Web Chat Skills (Queues) article.



15. After web chat skill is created successfully, text routing rules shall be defined.

For detailed information about Text Routing Rules, please check out Text Routing Definitions article.



Tegsoft makes no representations or warranties, either express or implied, by or with respect to anything in this document, and shall not be liable for any implied warranties of merchantability or fitness for a particular purpose or for any indirect, special or consequential damages.

Copyright © 2022, Tegsoft. All rights reserved.

"Tegsoft" and Tegsoft’s products are trademarks of Tegsoft. References to other companies and their products use trademarks owned by the respective companies and are for reference purpose only.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.