preloader

JSON API Connector

JSON API Connector

JSON API connector sends JSON data to any of your provided external URLs. Once any specific event mentioned below is triggered, the system will send JSON data to your provided webhook URL & it will wait for 10 seconds to get a response. If the system does not get a response in 10 seconds, it will send another post request to your webhook. You can then process your data as you want. This feature can be used to connect our system with any third-party app like Zapier or your own custom app. You will find JSON API connector features inside the Messenger Bot menu.

 

CONNECTION LIST: ACTIVITY, EDIT, DELETE

In the JSON API Connector dashboard, you will see all of your created connections. You can also view the activity report, update and delete your connections from the Connector dashboard.

 

CREATE NEW CONNECTION

To create a new connection click the New Connection button.

 Connection Name: This is the field of what will be your connection name.

 Webhook URL: This is the field of webhook URL to receive data. You can put any webhook URL in this field to receive data that you can get from any third-party apps like Zapier or your own custom app. The system will send data to your provided Webhook URL as JSON like below and it will wait for 10 seconds to get a response.

 Select a page: In this section, you will see the page lists of your bot enabled pages of messenger bot. So you’ve to select a page from which you want to collect triggered data.

 What field change trigger webhook: There are six triggering options in this section: email, phone number, location, postback, birthdate, and webview form. For example: if you select email, so when any new email is collected through a quick reply of messenger bot, then webhook will be triggered. You can select all options together and then the webhook will be triggered for all the events. Postback events will require choosing the postback ids and webview event will require choosing webview form ids.

 Which data you want to send: There are different options of data of the user which are collected through quick reply and the system will send selected data during triggering. A sample data will look like below:


{  
"psid":"12765756",
"first_name":"Test",
"last_name":"User",
"subscribed_at":"2019-01-15 12:19:04",
"email":"testuser@gmail.com",
"labels":"Demo,Demo Label 1,new-label-test",
"page_id":"37674343246",
"page_name":"Test Page",
"phone_number":"+88025192523",
"user_location":"",
"postbackid":"",
"subscriber_id":"2251324188330310",
"webview_form_id":"83c567cd88",
"product-type":"Shoes",
"Size":"Medium",
"Phone-Number":"88823",
"Delivary-Date":"2019-09-30"
}
                                    

 

CONNECTION REPORT

Just click on the view button and see the last 10 activities of your connection as well as connection setup information. HTTP Code: 200 means connection triggered successfully. You can see the data list in the Post Data section which was sent when the connection is triggered.

 

ADD OWN CUSTOM SCRIPTS URL AS WEBHOOK URL USING PHP

Suppose your domain is https://example.com and your script name is test.php, so your webhook URL will be https://example.com/test.php. When any selected event is triggered, it will send data to this URL. To receive the data sent by our system write the following code in test.php


$webhook_data= file_get_contents("php://input");
$webhook_data_array=json_decode($webhook_data,true);