| id | title | sidebar_label |
|---|---|---|
webhooks |
Webhooks |
Webhooks |
import useBaseUrl from '@docusaurus/useBaseUrl'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
Webhooks allow integration between Sauce Mobile App Distribution and your backend. Using these webhooks, you can subscribe for specific events and receive an HTTP POST request whenever such an event occurs.
You can use the webhooks when, for example, you'd like to receive a notification when a new build is uploaded and send it to the development team. Another example may be that you'd like to save the feedback received in your database or backend.
To configure webhooks, open the Webhooks tab in your User Preferences page. You can configure more than one webhook, and each webhook applies to selected projects and selected events.
Sauce Mobile App Distribution automatically detects Slack endpoints and sends an appropriate payload. Follow the Slack integration guide.
| Events | Description |
|---|---|
| Upload | Every time a build is uploaded by one of the team members |
| Download | Every time a tester downloads a build via invitation link |
| Crash | Every time the app crashes |
| Feedback | Every time a tester fills in feedback, whether it's in-app or web |
The payload of the HTTP POST request is always JSON. The event field specifies the type of event, and all the others are specific for that type. Review the payload examples below for more information about each event's key/value pairs.
{
"event": "upload",
"timestamp": "2015-07-01 13:37:54",
"version": "1.0",
"build": 1,
"appName": "Demo App",
"filesize": 563876,
"iconUrl": "https://testfairy.s3.amazonaws.com/icons/4/68348e8d8265771d64636e2d57bb9a672f812e1a.png",
"communityUrl": "https://tsfr.io/myapp"
}{
"event": "download",
"timestamp": "2015-07-01 13:37:54",
"version": "1.0",
"build": 1,
"appName": "Demo App",
"filesize": 563876,
"buildUrl": "https://app.testfairy.com/projects/10-demoapp/builds/584120",
"iconUrl": "https://testfairy.s3.amazonaws.com/icons/4/68348e8d8265771d64636e2d57bb9a672f812e1a.png",
"testerEmail": "[email protected]",
"referer": "http://my.testfairy.com"
}{
"event": "crash",
"timestamp": "2015-07-01 12:01:59",
"version": "1.0",
"build": 1,
"appName": "Demo App",
"filesize": 563876,
"buildUrl": "https://app.testfairy.com/projects/10-demoapp/builds/584120",
"iconUrl": "https://testfairy.s3.amazonaws.com/icons/4/68348e8d8265771d64636e2d57bb9a672f812e1a.png",
"email": "[email protected]",
"deviceName": "Samsung Galaxy S2",
"rawDeviceName": "samsung gt-i9100t",
"crashMessage": "java.lang.NullPointerException",
"ipAddress": "54.227.255.225"
}{
"event": "feedback",
"timestamp": "2015-07-01 17:21:00",
"version": "1.0",
"build": 1,
"appName": "Demo App",
"filesize": 563876,
"buildUrl": "https://app.testfairy.com/projects/10-demoapp/builds/584120",
"iconUrl": "https://testfairy.s3.amazonaws.com/icons/4/68348e8d8265771d64636e2d57bb9a672f812e1a.png",
"sessionUrl": "https://app.testfairy.com/projects/10-demoapp/builds/584120/sessions/1",
"screenshotUrl": "https://app.testfairy.com/projects/10-demoapp/builds/584120/sessions/1/screenshots/d64636e2d57672f812e1a348e8.jpg",
"correlationId": "user-95",
"email": "[email protected]",
"rawDeviceName": "samsung gt-i9100t",
"ipAddress": "54.227.255.225",
"text": "App doesn't render nicely in landscape"
}