## Hva webhooken sender

En webhook er en adresse hos deg som BulkGate rapporterer til om hva som har skjedd
med meldingene dine. Portalen kaller den `Leveringsrapporter`, men sender to ting
til den samtidig:

| Hva som kommer | Hvordan du kjenner det igjen |
|:--|:--|
| Leveringsrapport | En post med statusen til en sendt melding og dens `smsID` |
| Innkommende SMS (et svar) | En post med `status` `10`, avsenderen i `from` og meldingsteksten |

Det er altså ikke to separate innstillinger — én adresse håndterer både
leveringsrapporter og svar.

Dataformatet avhenger av om massesending er slått på:

| Modus | Hvordan dataene kommer | Formatet er beskrevet på |
|:--|:--|:--|
| standard | Én forespørsel per melding, med GET | [Leveringsbekreftelser](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-leveringsbekreftelser-og-innkommende-sms/) |
| `Bulk DLRs - bulk forespørsel` | En samling poster, med POST og `application/json` | [Leveringsbekreftelser for masseutsendinger](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-masseleveringsbekreftelser-og-innkommende-sms/) |

## Hvor webhooken angis

Stedet avhenger av hvilket grensesnitt du bruker. De to første trinnene er de samme i
alle tilfeller — klikk på `Moduler og APIer` i portalmenyen og åpne kortet for
applikasjonen din under `Mine APIer og moduler`.

| Grensesnitt | Hvor i applikasjonsdetaljene |
|:--|:--|
| HTTP API | Fanen `Innstillinger`, delen `Web hooks`, kortet `Leveringsrapporter` |
| `Email > SMS` | Bare `E-postleveransrapporter` — rapportene kommer på e-post, ikke til en URL |

## Slik slår du på webhooken

Kortet viser om noe er angitt. Så lenge ingenting er det, viser det
`Du har ingen innstillinger.` og knappen `Konfigurer`.

![Delen Web hooks med kortet Leveringsrapporter](docs:api-webhooks/webhooks_en)

Knappen `Konfigurer` (eller `Redigere` hvis du allerede har innstillinger) åpner
vinduet `Innstillinger for leveringsrapporter`.

![Vinduet Innstillinger for leveringsrapporter med feltet URL-leveringsrapporter](docs:api-webhooks/delivery-report_en)

Skriv inn en adresse som begynner med `http://` eller `https://` i feltet `URL-leveringsrapporter`
— portalen godtar ingen annen skrivemåte. Tre avkrysningsbokser hører
til:

| Alternativ | Hva det gjør |
|:--|:--|
| `Slå av sjekk for tilgjengelighetsadresser` | Portalen sjekker ikke at adressen svarer før lagring |
| `Rapporter kun når feil oppstår` | En rapport kommer bare for en mislykket melding |
| `Bulk DLRs - bulk forespørsel` | Rapportene kommer samlet i stedet for én og én |

Du lagrer oppsettet med knappen `Lagre`.

> [!TIP]
> Massesending er nyttig ved store volumer — i stedet for én forespørsel per melding
> kommer én enkelt forespørsel med en array av poster. Formatet for samlingen er beskrevet
> på [Leveringsbekreftelser for masseutsendinger](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-masseleveringsbekreftelser-og-innkommende-sms/).

Når webhooken er angitt, viser kortet tre rader — `URL` med adressen, og
et ikon for hver av `Rapporter kun når feil oppstår` og `Bulk DLRs - bulk forespørsel`
som viser om de er slått på.

## Slik fjerner du webhooken

Pilen ved siden av knappen `Redigere` åpner en meny med valget `Slett`. Bekreftelsesvinduet
`Slett innstillinger` advarer om at du mister innstillingene for
leveringsrapporter, og at de slutter å komme.

> [!WARNING]
> Når du fjerner webhooken, stopper også innkommende meldinger — svar på SMS-ene dine har
> ingen steder å bli levert.