FACEBOOK CONFIGURATION

The facebook configuration guide of following topics:

• IBCS Configurations
• OBDX Servers Configurations

Create a Facebook account for the Bank

1. Login to Facebook with this credentials.
2. Create a new page.

3. Navigate to developer link and create an application as shown below.

4. Navigate to dashboard page and note the app secret.

5. Navigate to Messenger > Settings page from left panel and in token generation section select the page created previously. Note the page access token.

6. In the webhook section select the events.

7. Navigate to Webhook > Edit Subscription.

8. Add the IBCS URL here.
   IBCS URL should be available on the internet for Facebook to get access. One can configure ngrok to IBCS and get the tenant URL for the same. This URL is obtained from below screen in IBCS. The verify token is also obtained here

IBCS Configurations

1. Login to IBCS and import the OBDX bot shipped with OBDX installer. This is a json (OBDX.json) file obtained in the installer in OBDX_Installer/installables/chatbot/config directory. Import this by clicking the “Import Bot” on IBCS dashboard.

2. Click on the OBDX Bot.

3. Update the Page access token and App Secret created previously in Facebook console.
4. Navigate to Webhook and enter the OBDX URL here. The OBDX setup and the IBCS setup must be accessible either in the same LAN, else host OBDX on internet using ngrok

5. Add username/password (in HTTP Basic authorization) of any user with Administrator role which can be used to login in OBDX Weblogic server.

OBDX Servers Configurations

Ensure that below applications are running on OBDX server

• com.ofss.digx.appx.chatbot.rest
• com.ofss.digx.chatbot

In chatbot.properties in com.ofss.digx.chatbot.ear > com.ofss.digx.chatbot.jar, enter the base URL of the OBDX server where DIGX application is running.

Note: Enter the Weblogic port. If using OHS, that should not be patched with Webgate

If the server needs proxy to connect to internet, enter proxy details here else leave them blank. This call is required for the chatbot to display the typing.. icon in chat. The connection is directly from OBDX Chatbot application to Facebook. The access token of the Facebook page is also required here (which is generated on Facebook console in step 3e).

Redeploy the ear after above changes

Asserter is required so that OBDX can assert the identity of the user who has a valid token. This token is issued by OBDX once mobile number and OTP validation is successful. Asserter jar is available in the installer in OBDX_Installer/installables/custom_asserter Custom Asserter directory

• Add OBDXJWTAsserter to Weblogic

Copy the OBDXJWTAsserter.jar to weblogic home at below location –

<Weblogic Home>/Middleware/wlserver/server/lib/mbeantypes

Restart Admin/Managed servers

Login to Admin console and add the selected asserter

Add the asserter and give any name. Restart admin and managed servers.

Verification Steps

1. Check if OBDX server Chatbot application is running and accessible over the component URL given to IBCS. Open a browser and enter the URL as entered in IBCS component services.

2. Login to IBCS and click OBDXBot > Test.

Enquire about account balance

1. Login to Facebook > Navigate to the page and click > Send message.

2. Click Get Started in the chat window > You should receive welcome message from IBCS.
3. Enquire about account balance > OTP should be received on given mail ID in party creation in core banking.

Back