Webhooks allow one to create integrations based on actions inside Falcony. Currently there is only one webhook available - for observation creation.
If you want to start using webhooks you will first need to contact our sales. Once your organization has webhooks enabled you need to send us the desired web address (URL) to which the observation creation webhook sends the observation payload.
Once this setup is complete, everytime a new observation gets reported the observation information gets sent to the desired address. The observation information is in the following format:
{
"data": {
"attributes": {
"answers": {
"47792": "Example description",
"47793": 0,
"47794": 45,
"47807": 9
},
"closed_at": null,
"created_at": "2020-09-10T08:12:00Z",
"deadline": null,
"is_published": true,
"number": "20",
"occurred_at": "2020-09-10T08:12:00",
"status": "none",
"title": null,
"updated_at": "2020-11-26T08:12:54.811476"
},
"id": "bf0c83ed-bf8a-4ca9-9ce6-0dbdc0759425",
"meta": {
"revision": "30765492"
},
"relationships": {
"assignees": {
"data": []
},
"attachments": {
"data": []
},
"audit": {
"data": null
},
"audit_question": {
"data": null
},
"created_by": {
"data": {
"id": "1786572",
"type": "users"
}
},
"place": {
"data": {
"id": "77507",
"type": "places"
}
},
"template": {
"data": {
"id": "131415",
"type": "observation-templates"
}
}
},
"type": "observations"
},
"included": [
{
"attributes": {
"ask_for_title": false,
"default_deadline_interval": null,
"icon": "counterfeit_cash",
"name": "Counterfeit cash",
"name_translations": {
"en": "Counterfeit cash",
"fi": "V\\u00e4\\u00e4r\\u00e4 raha"
},
"requires_follow_up_actions": false
},
"id": "131415",
"relationships": {
"question_groups": {
"data": [
{
"id": "64869",
"type": "observation-question-groups"
},
{
"id": "64870",
"type": "observation-question-groups"
},
{
"id": "64871",
"type": "observation-question-groups"
},
{
"id": "64872",
"type": "observation-question-groups"
}
]
}
},
"type": "observation-templates"
},
{
"attributes": {
"current_user_can_create_audit": false,
"is_archived": false,
"latitude": 60.167739,
"longitude": 24.936235,
"name": "05182 Gibson Lakes"
},
"id": "77507",
"relationships": {
"tags": {
"data": [
{
"id": "592afa86-de55-4e74-a315-3eb18a4a933c",
"type": "tags"
},
{
"id": "8a5cd5e4-f8a4-4391-9f38-572911a316bf",
"type": "tags"
}
]
}
},
"type": "places"
},
{
"attributes": {
"email": "trevor.williams@incy.io",
"first_name": "Trevor",
"last_name": "Williams",
"locale": "en",
"name": "Trevor Williams"
},
"id": "1786572",
"type": "users"
}
]
}