Knowledge Center
Get familiar with Applivery and explore the features

Custom webhooks

Now you can integrate Applivery with your platform using Custom Webhooks and start receiving notifications in when the following events take place:

  • A new Build has been uploaded
  • A new Feedback report has been received
  • A new Bug report has been received
  • New MDM Enrollment Token created
  • New MDM Device has been successfully enrolled

Integrate Applivery using Custom Webhooks is quite simple. Just follow the next steps:

Step 1

Custom webhooks can be enabled at both Organization and App levels:

  • Organization: messages coming from all the Apps within your organization will be posted to the selected URLs
  • Apps: messages coming only from the selected App will be posted to the selected URLs

Once you have decided which type do you prefer, go to your Apps (from the left side menu) and select one of your Apps or go the your Organization Settings (from the left side menu as well).

Then go to the Integrations and click “New Integration” button and then click the “Webhook” option

Step 2

Type the URL that you want to receive the webhooks and select the events you want to receive from the list below. Then click “Save changes” to finish.

Step 3

Once saved. You will be automatically redirected back to your App or Organization Integrations section where the new Webhooks integration should be listed, including all the details you have selected:

  • Type: Webhook
  • Configuration: URL that will be notified
  • Events: list of events that will be notified

Edit and existing Webhooks integration

You can edit your current Webhooks Integrations at any time by going to the Integrations section of your Organization or App and then clicking any of your existing Webhooks Integrations. A side panel will be opened allowing you to choose which events will be posted and the available events. You will be able to also delete the integration by clicking the “Delete notification” button.

Messages specification

Depending on the type of event taking place in the Applivery platform, you will receive different notification messages in JSON. You will be able to differentiate them based on the “action” field that will contain one of the following options:

  • build_created: a new Build has been uploaded and queued but has not been processed yet.
  • build_processed: a new build has been processed and is ready to install
  • bug_created: a new Bug Report has been created
  • feedback_created: a new Feedback Report has been created
  • enrollment_token_created: a new MDM enrollment token has been created
  • emm_device_created: a new MDM device has been successfully enrolled

Please check some examples below:

{
  "action": "build_created",
  "organization": {
    "id": "5d4d1391cd523c15f50df235",
    "name": "Applivery Test",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5e790ce04faa50cac52e4676",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "build": {
    "id": "5e79232e98d88ac68cf7d4bc",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/builds?id=5e79232e98d88ac68cf7d4bc"
  }
}
{
  "action": "build_processed",
  "organization": {
    "id": "5d4d1391cd523c15f50df235",
    "name": "Applivery Test",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5e790ce04faa50cac52e4676",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "build": {
    "id": "5e79232e98d88ac68cf7d4bc",
    "os": "android",
    "versionName": "",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/builds?id=5e79232e98d88ac68cf7d4bc"
  }
}
{
  "action": "bug_created",
  "organization": {
    "id": "5c9921fbb9f3bb001cc5c9a9",
    "name": "Applivery Dev",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5cd19870cdecf8001bef50b7",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "report": {
    "message": "This is a Bug message that will be included in the Report along with the technical information of the device",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/reports?id=5e7923a976b4b0e9aa4aa6a9"
  }
}
{
  "action": "feedback_created",
  "organization": {
    "id": "5c9921fbb9f3bb001cc5c9a9",
    "name": "Applivery Dev",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5cd19870cdecf8001bef50b7",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "report": {
    "message": "This is a Feedback message that will be included in the Report along with the technical information of the device",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/reports?id=5e7923a976b4b0e9aa4aa6a9"
  }
}
{
   "action":"enrollment_token_created",
   "sendEmail":true,
   "enrollmentToken":{
      "type":"Fully Managed"
   },
   "mdmUser":{
      "id":{
         "id":"5e9099ee4da32b180204770e",
         "email":"email@domain.com"
      },
      "email":"cesar@applivery.com",
      "url":"https://dashboard.applivery.io/test/mdm/users/5e9099ee4da32r180204770e"
   },
   "organization":{
      "id":"5d4d1391cd523c15f50df235",
      "name":"Applivery Test",
      "url":"https://dashboard.applivery.io/test"
   }
}
{
    "action":"emm_device_created",
    "organization":{
       "id":"5d4d1391cd523c15f50df235",
       "name":"Applivery Test",
       "url":"https://dashboard.applivery.io/test"
    },
    "emmDevice":{
       "type":"Fully Managed",
       "url":"https://dashboard.applivery.io/test/mdm/users/5e9099ee4da32b180204770e?id=5f634c11034824062256e38c"
    },
    "mdmUser":{
       "id":"5e9099ee4da32b180204770e",
       "email":"cesar@applivery.com",
       "url":"https://dashboard.applivery.io/test/mdm/users/5e9099ee4da32b180204770e"
    }
}