Listen Integration
LISTEN INTEGRATION
Necessary information to integrate the data into your own system

How can I do Listen Webhook integration?

You can transfer the contents which are compatible with the alert rules through the webhook API to your services too.

The first thing to do here is to create an API endpoint and an url for your service to insert data by using this API.

As you can see below, the Listen Webhook API creates the data output.

{
   "Data": {
       "event": {
           "name": "PostCreated"
       },
       "post": {
           "content": "Falcon 9 has landed – first West Coast land landing of an orbital class rocket booster.",
           "url": "https://twitter.com/SpaceX/status/1049125778841989120",
           "publishedDate": "2018-10-08 05:34:00",
           "processedDate": "2018-10-08 05:36:00",
           "companyId": "7697",
           "source": {
               "id": 1,
               "name": "Twitter",
               "domain": "twitter.com"
           },
           "user": {
               "id": 229021888,
               "name": "SpaceX",
               "screenName": "SpaceX",
               "imageUrl": "https://pbs.twimg.com/profile_images/671865418701606912/HECw8AzK_bigger.jpg",
               "followerCount": 7410000
           }
       }
   }
}

You can complete the integration by using the url of which you created on your side by following these steps:

  • Please go to the profile settings by clicking on the settings button, which is on the top-left.
  • Click on the “Integration” option, which is on the menu in your profile settings.
  • Select the “Webhook” option on the Tip section on the page you encounter.
  • Write down the name of this list on the details part. For example, you can write “Customer Services” if those in this channel are part of the customer management team, who are responsible only for complaint management; or, you can write “Digital Marketing”, if those in this channel are the digital marketing team.
  • “v1.0” should remain selected in the version part.
  • Besides, you need to copy  the url of which you created through your service as it is and past it under the Url part.
  • Lastly, click on the “Add” button so that you have just started the first step of the Webhook integration.
Now, you can create a new rule through the Alert Rules part on the left-menu or add this list to the existing rule. For further information, you might look at the article on “Alert Rules”.