Koppling av felanmälan till externa system

Inställning av din webhook

För att ställa in webhooken går du till sidan för inställning av felanmälningar och expanderar rubriken "Avancerat" längst ner på sidan.

Där finns två textfält:

Webhook-URL

Detta är URL:en som anropas när en ny felanmälan görs. URL:en måste börja med https:// eller http://.

Webhook-hemlighet

Detta är ett valfritt värde. Om det fylls i skickas det i headern Bosse-Secret. Värdet kan användas för att verifiera att anropet till URL:en som angavs ovan kommer från oss.

Vi rekommenderar att sätta hemligheten till en lång, slumpmässigt genererad textsträng. Hemligheten bör hanteras med försiktighet, och inte delas med någon annan än oss och mottagaren.

Beskrivning av data

Informationen som skickas i webhooken har formatet multipart/form-data och innehåller följande fält:

• errorReportId: Ett autogenererat nummer som identifierar felanmälan i Bosse.
• title: Titeln som användaren angav.
• location: Platsen som användaren angav.
• content: Innehållet som användaren angav.
• created: Tidpunkten då felanmälan skapades. Enligt ISO 8601.
• address: Adressen till den användarens bostad i Bosse.
• homeNumber: Numret på användarens bostad i Bosse.
• authorName: Namnet på användaren som skapade felanmälningen.
• authorEmail: E-postadressen till användaren som skapade felanmälan.
• attachments: Eventuella filer som har bifogats. Detta fält uppkommer så många gånger som det finns bifogade filer.

Exempel

Nedan följer ett exempel på data som skickas när en felanmälan skapas:

POST /webhook/error-report
Host: example.com
Connection: close
Content-Length: 1198
Accept-Encoding: gzip, br
X-Forwarded-For: 203.0.113.74
X-Forwarded-Proto: https
Accept: application/json, text/plain, */*
Content-Type: multipart/form-data; boundary=--11024243812
Bosse-Secret: VlZS40HegxPFOKG5NhK6SJ+FkFSZ71jGNE+WYkyHeF0=
User-Agent: axios/1.7.2

--11024243812
Content-Disposition: form-data; name="errorReportId"

106
--11024243812
Content-Disposition: form-data; name="title"

Kranen läcker vatten
--11024243812
Content-Disposition: form-data; name="location"

Köket
--11024243812
Content-Disposition: form-data; name="content"

Det läcker vatten mellan kranen och diskbänken.
--11024243812
Content-Disposition: form-data; name="created"

2024-05-21T18:08:32.055Z
--11024243812
Content-Disposition: form-data; name="address"

Trastgatan 1
--11024243812
Content-Disposition: form-data; name="homeNumber"

Lgh. 1201
--11024243812
Content-Disposition: form-data; name="authorName"

Conny Svensson
--11024243812
Content-Disposition: form-data; name="authorEmail"

conny.svensson@example.com
--11024243812
Content-Disposition: form-data; name="attachments"; filename="image1.jpg"
Content-Type: image/jpeg

[Innehåll i jpeg-fil 1]

--11024243812
Content-Disposition: form-data; name="attachments"; filename="image2.jpg"
Content-Type: image/jpeg

[Innehåll i jpeg-fil 2]

--11024243812--